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Warning 

This equipment has been certified to comply with the limits for a 
Class B computing device, pursuant lo Subpart J uf Part 15 of FCC 
Ruies, Only peripherals (computer input.'output devices, terminals, 
printers, etc.) certified to comply with the Class B limits may be 
attached to this computer. Operation with non-certified peripherals is 
likely to result in interference to radio and TV reception 
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Radio and Teievision interference 



The equipment described in this manual generates and uses radio- 
frequency energy. If il is not installed and used properly, that is, in. 
strict accordance with our instructions, it may cause interference 
with radio and television reception. 

This equipment has been tested and complies with the limits for a 
Class B computing device in accordance with the specifications in 
Subpart J, Part 15, of FCC rules. These rules are designed to 
provide reasonable protection against such interference in a 
residential instaJlation. However, there is no guarantee (hat the 
interference wilf not occur in a particular installation, especially if 
you use a "rabbit ear" television antenna. {A "rabbit ear" antenna is 
the telescoping-rod type usually contained on TV receivers.) 

You can determine whetJier your computer is causing interference 
by turning il off. If the interference stops, it was probably caused 
by the computer or its periphery devices. To further isolate the 
problem: 

• Disconnect the peripheraJ devices and their input/output cables 
one al a time. If the interference stops, it is caused by either 
the peripheral device or its I/O cable. These devices usualiy 
require shielded 10 cables. For Apple peripheral devices, you 
can obtain the proper shielded cable from your dealer. For non- 
Apple peripheral devices, contact the manufacturer or dealer 
for assistance. 

If your computer does cause interference to radio or teievision 
reception, you can try to correct the interference by using one or 
more of the following measures: 

■ Turn the TV or radio antenna until the Interference stops. 

■ Move the computer to one side or the other of the TV or radio. 

• Move ti^e computer farther away from the TV or radio. 

• Plug tlie computer into an outlet that is on a different circuit 
than the TV or radio. (That is, make certain the computer and 
the radio or television set are on circuits controlled by different 
circuit breakers or fuses.) 

• Consider installing a rooftop television antenna with coaxial 
cable lead in between the antenna and TV. 



It necessary, you should consult your dealer or an experienced 
radio/television technician for additionaJ suggestions. You may find 
helpful the following booklet, prepared by the Federal 
Communications Commission: 

"How to tdentify ^nd Resoive Radio-TV interference Problems" 

This bookfet is available from the U S Government Printing Office, 
Washington. DC 20402. stock number 004-000-00345-4. 
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Foreword 



This Fs the reference manual for the Apple lie personal computer. 
It contains detailed descriptions of all of the hardware and 
firmware that make up the Apple lie and provrdes the technical 
information that peripheral-card designers and programmers 
need. There is an Addendum, bound separately, that contains 
source Ifstings of the built-in firmware. 

This manual contains a lot of information about the way the 
Apple He works, but it doesn't tell you how to use the Apple lie. 
For this, you should read the other Apple lie manuals, especially 
the following: 

• The Apple Ne Owner's Manual 

• The Applesoft Tutorial 

This manual is designed to answer the question, What's inside 
the box? ft describes the internal operation cf the Apple lie as 
completely as possible in a single volume. The criterion for 
deciding lo include an item of information was whether it would 
help an assembly-language programmer or peripheral designer. 

Contents of This Manual 

The material in this manual is presented roughly in order of 
increasing intimacy with the hardware; the farther you go in the 
manual, the more technical the material becomes. The main 
subject areas are 

• Introduction: Foreword and Chapter 1 

• Use of built-in features: Chapters 2 and 3 

• How the memory fs organized: Ctiapter 4 

• Information for programmers: Chapters 5 and 6 
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■ Hardware implementation: Chapter 7 

• Additional information: Appendices and Addendum 

Chapter 1 identifies the main parts of the Apple Me and tells 
where in the manual each part Is described. 

The next two chapters describe the built in tnput and output 
features of the Apple lie. This part of the manual includes 
information you need for low-level programming on the Apple lie. 
Chapter 2 describes the built-in I/O features and Chapter 3 tells 
you how to use the firmware that supports them. 

Chapter 4 describes the way the Apple lie s memory space is 
organised, including the allocation of programmable memory for 
the video dispiay buffers. 

Chapter 5 is a user manual for the Monitor that is included in the 
built-in firmware. The Monitor is a system program that you can 
use for program debugging at the machine level. 

Chapter 6 describes the programmable features of the peripheral- 
card connectors and gives guidelines for their use 

Chapter 7 is a detailed description of the hardware that 
implements the features described in the earlier chapters. This 
information is included primarily for programmers and peripheral- 
card designers, but it will also help you if you just want to 
understand more about the way the Apple lie works. 

Addilionai reference information appears in the appendices. 
Appendix A is the manufacturer's description of the 6502 
instruction set. 

Appendix B contains additional copies of some of the tables that 
appear in the body of the manual. The ones you wiil need to 
refer to often are duplicated here for easy reference. 

Appendix C is a directory of the built-in 1^0 subroutines, including 
their functions and starting addresses. 

Appendix D lists the differences between the Apple lie and the 
earlier Apple II and Appfe II Plus models and tells you which 
sections to look at for more information. 
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Following Appendix D is a giossary defining many of the 
technicai terms used in this manual. Some terms that describe 
the use of the Apple Me are defined in the giossanes of the other 
manuals listed above. 

Following the appendices, there is a selected bibliography of 
sources o( additional information. 

The Addendum to this manual contains the source fisting of the 
Monitor firmware. You can refer lo it to find out more about the 
operation of the Monitor subroutines listed in Appendix C, 

Symbols Used in This Manual 

Special text in this manual is set off in several different ways, as 
shown in these exampfes 



Informat ion that op pears on the displa 
set off by this sc reen- shaped out 1 ine . 



Warning 

Innpcrtant warnings appear in boxes like this. 



y screen \ 5 



Captions, definlltons, and oJher short Information that fs useful but is incidental to the texl appears in grey 
Items appear in marginal glosses like boxes like this. You may want to skip over such boxes and return to 

them later. 
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Chapter 1 



Introduction 



This first chapter introduces you to the Apple He itself It shows 
you what the inside looks like, identifies the major components 
that make up the machine, and tells you where to find 
information about each one. These major components are shown 
in the diagram in Figure 1.1. 



Figure 1-1 Exploded 
Apple lie 



Diagram oJ the 
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Removing the Cover 

Remove the cover of the Apple flie by pulling up on the back 
edge until the fasteners or^ either side pop loose, then move the 
cover an inch or so towards the rear of the machine to free the 
front oi the cover, as shown in Figure 1-2. What you will see is 
shown in Figure 1-3. 




There is a red LED Oight-emitting diode) inside the Apple lie, in the 
left rear corner of the Circuit board H the LED is on* Jt means that 
the power Is on and you must turn it off before you Insert or 
remove anything. To avoid damaging the Apple He, don't even 
THINK of changing anything inside it witfioul first turning off the 
power. 
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The Keyboard 

The keyboard is the Apple lie s primary Input device. As shown in 
Figure 1-4, it has a normal typewriter layout, upper- and 
lowercase, with all of the special characters in the ASCII 
character set. (ASCII stands for American Standard Code for 
Information interchange.) The keyboard es fully integrated into the 
machine; its operation is described in the first part of Chapter 2. 
Firmware subroutines for reading the keyboard are described in 
Chapter 3. 
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The Speaker 

The Apple lie has a small loudspeaker in the bottom of the case, 
as shown in Figure 1-1. The speaker enables AppJe lie programs 
to produce a variety of sourids that make the programs more 
useful and interesting. The way programs control the speaker is 
described in Chapter 2. 

The Power Supply 

The power supply is inside the flat metal box along the left side 
of the interior of the Apple Me. It provides power for the main 
board and for any peripheral cards installed in the Apple Me. 

The power supply produces four different voltages: -i-5V, -5V, 
+ 12V, and -12V. It is a high-efficiency switching supply, and 
includes special circuits that protect it and the rest of the 
Apple Me against short circuits and other mishaps. Complete 
specifications of the Apple lie power supply appear In Chapter 7. 
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The power switch and the socket for the power cord are mounted 
directly on the back of the power supply's metal case. This 
mounting ensures that all the circuits that carry dangerous 
voltages are inside the power supply. Do not defeat this design 
feature by attempting to open the power supply. 



The CPU is a 6502B microprocessor. The 6502B is a high-speed 
version of the 6502, which is an eight-bit microprocessor with a 
sixleen-bit address bus. It uses instrucWon pipeiining for faster 
processing than comparable microprocessors. In the Apple lie, 
the 6502B runs at 1 MHz and performs up to 500,000 eight-bit 
operations per second. The specifications of the 6502B are given 
in Chapter 7; the 6502 instruction set is given in Appendix A, 

The keyt>Qard is decoded by an AY-36O0-type integrated circuit 
and a read-only memory (ROM). These devices are described in 
Chapter 7, 

The interpreter ROMs are integrated circuits that contain the 
Applesoft BASIC interpreter. The ROMs are described in 
Chapter 7. The Appiesoft language is described in the Appfesoft 
Tutoriat and the Applesoft Reference Manuaf 

Two of the iarge IC's are custom-made for the Apple lie: the 
MMU and the lOU. The MMU IC contains most of the logic that 
controls memory addressing in the Apple Me. The organization of 
the memory rs described in Chapter 4; the circuitry in the MMU 
itself is described in Chapter 7. 

The lOU IC contains most of the logic that controls the built-in 
input/output features of the Apple lie- These features are 
described in Chapter 2 and Chapter 3; the lOU circuits are 
described in Chapter 7- 



The Circuit Board ^ 

All of the electronic parts of the Apple He are attached to the M- 
circuit board, which is mounted flat in the bottom of the case. 

Figure 1-5 shows the main integrated circuits (iCs) in the 
Apple lie. They are the central processing unit (CPU), the 
keyboard encoder and read-only memory (ROM), the two 
interpreter ROIVls. and the custom integrated circuits: the Input 
Output Unit (lOU) and the Memory Management Unit (MMU). 
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Connectors on The Circuit Board 

The seven siots lined up along the back of the Apple Ite circuit 
board are the expansion slots, sometimes called peripheral slots 
(see Figure 1-6). These slots make it possible to attach additronal 
hardware to the Apple lie. Chapter 6 tells you how your programs 
deal with the devices that plug into these slots; Chapter 7 
describes the circuilry for the slots themselves. 



Figure 1-6 £xpar>sion Slots 




The large slot next to the left-hand side of the circuit board is the 
auxiliary slot (Figure 1-7). If your Apple lie has an Apple (le 80- 
column text card, it will be installed in !:his slot. The 80-column 
dispiay option Is tully integrated into the Apple lie; it is described 
along with the other display features in Chapter 2- The hardware 
and firmware Interfaces to this card are described in Chapter 7. 
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Figure 1-7 Auxiliary Slol 




Figufe 1-6 Back Panel Goone^ors 




There are also smaller connectors for game I/O and for an 
internal RF (radio frequency) modulator. These connectors are 
described in Chapter 7. 

Connectors on the Back Panel 

The back of the Apple lie has two miniature phone jacks for 
connecting a cassette recorder, an RCA-type jack for a video 
monitor, and a 9-pin D-type miniature connector for the hand 
controls, as shown in Figure 1-6. In addition to these, there are 
spaces for additional connectors used with the peripheral cards 
installed in the Apple lie. The installation manuals for the 
peripheral cards contain instructions for installing the 
peripheral connectors. 
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Chapter 2 

Built-in I/O Devices 



31 


This chapter describes the input and output (I/O) devices built 




into the Apple He in terms of their functions and the way they are 




used by programs. The buiit-in I/O devices are 




• keyboard 


Hi 


• video-display generator 




• speal<er 




• cassette input and output 




■ game Input and output 




At the lowest level, programs use the built-in I/O devices by 




reading and writing to dedicated memory locations. This chapter 




lists these locations for each I/O device It also aive^* the 




locations of the internal soft-switches that select the different 




display modes of the AppJe lle^ For descriptions of the buitt-in 




I/O hardware, refer to Chapter 7. 




This method of input and output — loading and storing directfy to 




specific locatioffs in memory — is not the only method you can use. 




For many of your programs, it may be more convenient to call the 




built-in I/O routines stored in the Appie lie's firmware. These 




firmware routines are describod in Chapter 3. 








^^^^^H The Keyboard 




The primary input device of the Apple Me is its built-in keyboard. 




The keyboard has 63 keys and is similar to the keyboard of a 




typewriter. The Apple lie keyboard has automatic repeat on all 




keys: hold the key down to repeat. It also has M-key rollover, 




which means that you can hold down any number of keys while 




typing another. 0( course, if you hold the keys down much longer 
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than the length of time you would hold them down during normal 
typing, the aulomatic-repeat function will start repeating the last 
key you pressed. 

The keyboard arrangement shown in Figure 2-1 is the standard 
one used in the United States. The specifications for the 
keyboard are given in Table 2-1. Apple lie's manufactured for 
sale in Europe have a slightly different standard keyboard 
arrangement and indude provisions for switching between two 
different arrangements. 



Figure Z-1 Tfie Keyboard 
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In addition to the keys normally used for typing characters, there 
are four cursor-controi keys with arrows: left, right, down, and up. 
The cursor-control keys can be read the same as other keys; 
their codes are $08, SI 5, $0A, and $0B (see Table 2''3a). 



Tabl« 2^1 Apple ile Keyboard 

Specifications 



Number of keys: 
Character ercoding: 
Number of codes; 
Special keys: 



Rollover'. 

Electrical intedace: 



63 

ASCII 

12B 



I CQNTRQL . [SHIFTI, I CftPS LOCK 1. 1 , E5C I 



I RESET ] , | LEFT-ftR WON|, GHT- RRHOhJ , 
|uP-ARRQmL IDOWH-ARhEw";, rQPVN-ftPPLEl 



SDLID-flPPLt 



N key 

AY-5"3BOa keyboard sncodar 
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Four special keys, | cdntrgl | , | 5H[FT | , | CflPS LDCKJ, and_^gc] 
change the codes generated by (he other keys. The [ cdntbdL" 
key is similar to the A SCJI CTR L key. Three other keys have 
speciai: functions: the I reset | key, and two keys marked with 
appl eSn one outlined, or open, and one solid, or closed. Pressing 
the I RESET ' key with the | cQnTrQl key depressed resets the 
Apple lie. as described In Chapter 4. The Apple keys are 
connected to the one-bit game inputs, described iater in (his 
chapter. 

The electrical interface between the Apple He and the keyboard is 
a ribbon cable with a 26'pin connector This cable carries the 
keyboard signals to the encoding circuitry on the main board, A 
complete description of the electrical interface to the keyboard is 
given in Chapter 7. 



Reading the Keyboard 

The keyboard encoder and ROM generate all 128 ASCII codes, 
so all of the special characler codes in the ASCII character set 
are available (rom the keyboard. Machine-language programs 
obtain characler codes from the keyboard by reading a byte from 
the keyboard-data location shown in Table 2-2. 



Table 2-2 Keyboard Memory Location 

Locations Hex Decimal Description 



ICO DO 491 S2 - 1639^ Keyboard data and strobe 

iCOl 49198 -1G369 Any-key<lawn Tlag end Clear-strobe swilcti 



Your programs can get the code for the last key pressed by 
reading the keyboard-data location. Table 2-2 gives this location 
in three different forms: the hexadecimal value used in assembly 
language, indicated by a preceeding dollar sign {$); (he decimai 
value used in Applesoft BASIC, and the complementary decimal 
value used in Apple Integer BASIC. {Integer BASIC requires that 
values greater than 32767 be written as the number obtained by 
subtracting 65536 from the value. These are the decimal 
numbers shown as negative in the tables: refer to the Appfe ii 
BASIC Programming ManuaL) The low-order seven bits of the 
byte at the keyboard location contain the character code, the 
high-order bit of (his byte is the strobe bit, described belov/. 



HeKadeclmar refers to the tiase-ta 
number system, wriich uses tfre ler 
digits throjgh 9 and the eIk tietters A 
through F to represent values from 
to 15- 
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Table 2-3b Keys and ASCI I Codes, 
coritinued 

Codes are shown here ir hexadecimal; 
to find' the decimal equivalents, jse 
Table 2 4 



V 



location. This location is a combination flag and switch; the flag 
tells wftether any key is down, and the switch clears the strobe 
bit. The switch function of this memory location is called a soft 
switch because it is controlled by software. In this case, it 
doesn't matter whether the program reads Of writes, and it 
doesn't matter what data the program writes' the only action that 
occurs is the resetting of the keyboard strobe- Similar soft 
switches, described later, are used for controlling other functions 
in the Apple lie. 

Any time you read the Any-key-down ffag, you also dear the 
keyboard strobe. If your program needs to read btJth the fiag and 
the 3trobe, it must read the strobe bit first 
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After the keyboard strobe has been cleared, it remains low until 
another key is pressed. Even after you have cleared the strobe, 
you can still read the character code at the keyboard location. 
The data byte has a different value, because the high-order bit is 
no longer set, but the ASCII code in the seven low-order bits is 
the same until another key is pressed, Tables 2-3a and 2-3b 
show the ASCII codes for most of the keys on the keyboard of 
the Apple Ife. 

TaWe 2-4 Thq ASCII Character Set 
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There are several special-function keys that do not gene rate 
ASCI I codes. Fore ifample,voucannotreadthercO MTRQL I , | shjft 
and [CAPS LDciTj keys directly, but pressfng one of these keys 
afters the character codes produced by the other keys. 



L 




Another key that doesn't generate a code is the [RESET] key, 
located at the upper-right corner of the keyboa rd; it is co nnected 
directly to the Apple lie's circuits. Pressing the [RESET] key with 
the LCDNTROJ^J key depressed normaJly causes the system to stop 
whatever program it s running and restart Itself. This restarting 
process is called the reset routine, and it is described in 
Chapter 4. 

Two more special keys are marked with two versions of the 
Apple logo and located on either side of the space bar. The key 
with the outlined apple is th e rpPEH-flPPLE "J key; the key with the 
solid-color appie is the [ saLlD-fl PPLE 1 key. These keys are 
connected to the one-bit game inputs, which are described later 
in this chapte r. Pressing them In combination with the [ cdntrol] 
and I RESET^I keys causes the built-in firmware to perform special 
reset and self-test cycles, described with the reset routine in 
Chapter 4. 

The Video Display GBnerator 

The primary output device of the Apple Me is the video display 
You can use any ordinary video monitor, either color or black- 
and-white, to display video information from the Apple lie. An 
ordinary monitor is one that accepts composite video compatible 
with the standard set by the NTSC (National Television 
Standards Committee), If you use Apple lie color graphics with a 
black-and-white monitor, the display will appear as different 
shades of gray. 

If you are only using 40-column text and graphics modes, you 
can use a television set for your video display. If the TV set has 
an input connector for composite vrdeo. you can connect \t 
directly to your Apple lie; if It does not. you ll need to attach an 
RF video modulator between the Apple Me and the television set. 

With the 80-column text card insialied. the Apple lie can produce an 
eO-column text display However, if you use an ordinary coior or 
black-and-white television set, SO-column text will be too blurry to 
read. For a dear 80-column display, you must use a high-resolution 
video monitor with a bandwidth of 14 MHz or greater. 
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The specifications for the video display are summarized in 
Table 2-5. 



Table 2-b Video Display 
Specifications 



Display modes: 



40-colLimn text 

SO-column te>:t with Dptional card 
Low- re solution Color graphics 
High-resolution color grepriics 



Text capacity: 



24 lines by 40 columns 
24 Irnes by 80 columns with 
optionet card 



Character set: 



96 ASCII characlefs 
(uppercase and lowercase) 



Display formats: 



Normal^ Inversen Flashing 



Low resolution graphics: 16 colors. 40 horizontal by 
48 vertical 

High-resolution graphics: 6 colors, 200 lioiizontal by 
19a vertical 



The video signal produced by the Apple lie is MTSC-compaliWe 
composite color video It is available at three places: the RCA- 
lype phono jack on the back ot the Apple He, the single Molex- 
type pin on the main circuit board near ttie back on the right 
side, and one of the group of four Molex-type pins in the same 
area on the main board. Use the RCA-type phono jack to 
connect a video monitor or an external video modulator; use the 
Molex pins \o connect the type of video modulator that fits inside 
the Apple Me case. For a full description o1 the video signal and 
the connections to the Molex-type pins, refer to the section 
"Video Output Signals" in Chapter 7. 

The Apple lie can produce four different kinds of video display: 

• Text, 24 lines of 40 characters 

• Text, 24 lines of 80 characters {with optional card) 

• Low-resolution graphics, 40 by 48, in 16 colors 

• High-resolution graphics, 280 by 192, in 6 colors 
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Either of the two text modes can display all 96 ASCII characters: 
me upper- and lowercase letters, numbers, and symbols. 



Either of the graphics displays can have four lines of text, either 
40-colunin or BO-column, at the bottom of the screen. Graphics 
displays with text at the bottom are called mixed-mode displays . 

The low-resoiutlon graphics display is an array of colored blocks, 
40 wide by 48 high, in any of sixteen colors. In mixed mode, the 
four lines of text replace the bottom eight rows of blocks, leaving 
40 rows of 40 blocks each. 

The high resolution graphics display is an array of dots, 280 wide 
by 192 high. There are sisc colors available in high-resolution 
displays, but a given dot can only use four of the six colors. In 
mixed mode, the four lines of text replace the bottom 32 rows of 
dots, leaving 160 rows of 280 dots each. 



Text Modes 

The text characters displayed Include the upper- and lowercase 
letters, the ten digits^ punctuation marks, and special characters. 
Each character is displayed in an area of the screen that is 
seven dots wide by eight dots high. The characters are formed 
by a dot matrix five dots wide, leaving two blank columns of dots 
between characters in a row. Except for lowercase letters with 
descenders, the characters are only seven dots high, leaving one 
blank lino of dots between rows of characters. 

The normal display has white (or other single color) dots on a 
black background. Characters can also be displayed as black 
dots on a white background; this is called inverse format. 

Text CharactBr Sets 

The Apple He can display either of two text character sets: the 
primary set or an alternate set. The forms of the characters in 
the two sets are actually the same, but the available display 
formats are different. The display formats are 

• normat, with white dots on a black screen; 

• inverse, with black dots on a white screen; and 

• ffashirig, alternating between normal and inverse. 



Ttie Video Display Generator 
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Table 2-6 The Drsplay Character Sets 

To identify particular characters and 
val jes, refer to Table 2-4. 



With the primary character set, the Apple lie can display 
uppercase characters in all three formats: normal, inverse, and 
flashing. Lowercase letters can only be displayed in normal 
format. The primary character set is compatible with most 
software written for the Apple II and Apple II Plus modets, which 
can display te>ct in flashing format but don't have towercase 
characters. 

The alternate character set sacrifices the flashing format for a 
complete inverse format. With the alternate character set, the 
Apple He can display uppercase letters, lowercase letters, 
numbers, and special characters in either normal format or 
inverse format. 

You select the character set by means of the alternate text soft 
switch, described below in the section "Display fylode Switching". 
Table 2-6 shows the character codes in decimal and hexadecimal 
for the Apple lie primary and alternate character sets in normal 
inverse, and flashing formats. 



Primary Character Set: Alternate Character Set: 



Hex Values 


Character Type 


Fofinat 


Character Type 


Formal 


$00-$ 1 F 


Uppercase letters 


Inverse 


Uppercase letters 


Inverse 




Special characlers 


Inverse 


Special characters 


Inverse 


S40-$5F 


Uppercase letters 


Flashing 


Uppercase letters 


Inverse 


S60-$7F 


Special characters 


Flashing 


Lowercase letters 


Inverse' 


$80-$9F 


Upfiercaee lelters 


Normal 


Uppercase letters 


Normal 


SAO -SB F 


Special characlars 


Normal 


Special characters 


Norniial 


SCO-$DF 


Uppercase letters 


Normai 


Uppercase lelters 


Normal 


$EO-SFF 


Lowercase l^etisrs 


Normal 


Lowercase letters 


Normal 
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Each character on the screen is stored as one byte of display 
data. The low-order six bits make up the ASCII code of the 
character being displayed. The remaining two (high-order) bits 
select inverse or flashing format and uppercase or lowercase 
characters. In the primary character set, bit 7 selects inverse or 
normal format and bit 6 controls character flashing. In the 
alternate character set, bit 6 selects between upper- and 
lowercase, according to the ASCII character codes, and flashing 
format is not available, 

40-cofunin versus 80-cotumn T&xt 

The Apple lie has two modes of text display: 40-column and BO- 
column. (The SO-column display mode described in this manual is 
the one you get with the SO-cotomn text card or other auxiliary- 
memory card installed rn the auxiliary slot.) The number of dots 
in each character does noi change^ but the characters in 80- 
column mode are only half as wide as the characters in 40- 
column mode Compare Figure 2-2 and Figure 2-3. On an 
ordinary color or black-and-white television set, the narrow 
characters in the 6Q-co(umn display biur together; you must use 
the 40-column mode to display text on a television set. 



□LIST 0. 106 

10 REM APPLESOFT CHARACTER DEHO 
20 TE^T - HOME 

70 PRINT = PRINT "Applesoft Ch^r 

49 PRIKT PRINT "Which characte 

50 PRINT ■■ INPUT "Prinary <P> or 

f^lternate <(^> 
£9 IF LEN < 1 THEN 58 

C5 LET = LEFT* (A*. 1 > 
79 IF A* = "P" THEN POKE 49166.. 
& 

S9 IF A* = "ft" THEt4 POKE 4916?. 



59 PRINT ■- PRINT " , , . pr i fpt i n9 th 

e s3Me line^ first" 
100 PRINT ° in then INUE 

PSE .then FLf\SH ■ " ■ PRINT 
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Figure 2-3 QO-column Teict Display 



m ■■ mi 

% PStIF -■ FtlHT "flpplesthft Character Dae' 
m m ■ PftlKT "Which chjrsctsr fst-" 

S [F L^ffux new 

65 L£Tflt= LEFUflt-1^ 

n nm ■ ppeht ■ , , .prints tf* sm nnt> FiRt' ■ , 



I lOT" kWttill- tlfe- 

t msL- im.m. 




PSlffT 'Press m t?«if " rspwt/. 




Graphics Modes 

The Apple He can produce video graphics in either of two 
different modes. Both graphics modes treat the screen as a 
rectangular array of spots. Normally, your programs will use the 
features of some high-level language to draw graphics dots, 
lines, and shapes in these arrays; this section descnbes the way 
the resulting graphics data are stored in the Apple He's memory. 

Low-resolution Gr&phSos 

In the low-resolution graphics mode, the Apple lie displays an 
array of 48 rows by 40 columns of colored bfocks. Each block 
can ba any one of sixteen cotors, including black and white. On 
a black-and-whEte monitor or television set, these colors appear 
as black, while, and three shades of gray, There are no blank 
dots between blocks; adjacent blocks of the same color merge to 
make a larger shape. 

Data for the low-resolution graphics display is stored in the same 
part of memory as the data for the 40-column text display. Each 
byte contains data for two low -resolution graphics blocks. The 
two blocks are displayed one atop the other in a display space 
the same size as a 40-column text character, seven dots wide by 
eight dots high. 

Half a byte — four bits, or one nybble — is assigned to each 
graphics block. Each nybble can have a value from to 15, and 
this value determines which one of sixteen colors appears on the 



J 
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Table 2-7 Lnw-resoluliDn Graphics 
Colors 

Colors may vary, depending upon the 
Controls or the monilor or television 
set. 



screen. The colors and their corresponding nybble values are 
shown in Table 2-7. In each byle, (he low-order nybble sets the 
color for the top block of the pair, and the high-order nybble sets 
the color for the bottom block. Thus, a byte containing the 
hexadecimal value $D8 produces a brown block atop a yellow 
block on the screen. 



^fybble Value Color 



Nybble Value Color 



Decimal 






Decimal 


Hex 







sa 


Black 


8 


$Q 


Brown 


1 


S1 


Magenta 


9 


S9 


Orange 


2 


S2 


Dark Blue 


10 


$A 


Grey P 


3 


S3 


Purple 


t1 


SB 


Pink 


4 


S4 


Dark Green 


ta 


$C 


Light Green 


5 


S5 


Grey 1 


13 


$D 


Yellow 


6 


S6 


Medium Blue 


14 


SE 


Aquamarine 


7 


S7 


Lighl Blue 


15 


$F 


White 



As explained belcw in the section "Display Pages", the text 
display and the low-resolution graphics display use the same 
area In memory. Most programs that generate text and graphics 
clear this part of memory when they change display modes, but it 
is possible to store data as text and display It as graphics, or 
vice-versa. All you have to do is change the mode switch, 
described in the section "Display Mode Switching", without 
changing the display data. This usually produces meaningiess 
jumbles on the display, but some programs have used this 
technique to good advantage tor producing complex low- 
resolution graphics displays quickly. 

High-resotution Graphics 

in the high-resotution graphics mode, the Apple Ife displays an 
array of colored dots in 192 rows and 280 columns The colors ^ 
available are biack, white, purple, green, orange, and blue, 
although the colors of the individual dots are limited, as 
described below. Adjacent dots of the same color merge to form 
a larger colored area. 
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Data for the high-resolution graphics displays are stored in eilher 
of two 8192-byte areas in memory. These areas are called htgh- 
resolution Page 1 and Page 2; think of them as buffers where 
you can put data to be displayed. Normally, your programs will 
use the features of some high-level language to draw graphics 
dots, lines, and shapes to display; this section describes the way 
the resulting graphics data are stored in the Apple He's memory. 

The Apple lie high- resolution graphics dispiay is bit mapped: each 
dot on the screen corresponds to a bit in the Appie lle^s memory. 
The seven low-order bits of each display byte control a row of 
seven adjacent dots on the screen, and forty adjacent bytes in 
memory control a row of 280 (7 times 40) dots. The least 
significant bit of each byte is dispiayed as the leftmost dot in a 
row of seven, fallowed by the second-least significant bit. and so 
on, as shown in Figure 2-4. The eighth bit (the most significant) 
of each byte is not displayed; it selects one oi two color sets, as 
described below. 

On a black-and-white monitor, there is a simple correspondence 
between bits in memory and dots on the screen. A dot is white if 
the bit controlling it is on {1 ), and the dot is black if the bit Is off 
(0). On a black-and-white television set, pairs of dots blur 
together; alternating black and white dots merge to a continuous 
grey. 

On an NTSC color monitor or a color television set. a dot whose 
controlling bit is off (0) is black. If the bit is on, the dot will be 
white or a color, depending on its position, the dots on either 
side, and the setting of the high-order bit of the byte. Call the 
left-most column ol dots column zero, and assume (for the 
moment) that the high-order bits of all the data bytes are off (0). 
If the bits that control them are on, dots in even-numbered 
columns, 0, 2. 4, and so forth, are purple, and dots in odd- 
numbered columns are green — but only if the dots on either 
side are black. If two adjacent dots are both on, they are both 
white. 

You select the other two colors, blue and orange, by turning the 
high-order bit (bit 7) of a data byte on (1). The colored dots 
controlled by a byte with the high-order bit on are eilher blue or 
orange: the dots in even-numbered columns are blue, and the 
dots In odd-numbered columns are orange — again, only If the 
dots on either side are black Within each horizontal line of seven 
dots controlled by a single byte, you can have black, white, and 
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Tabl« 2-0 High-resalulion Graphics 

Colors 

Colors may vary, depending on the 
adj jslment of the moniior or television 
set. 



ptgure 3*4 High-resolution Display Bits 
Biis m Data Byte 



= □ 



R 






3 




1 


U 
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2 
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5 





Dots or Graphics Screen 



one pair of colors. To change the color of any dot to one of the 
other pair of colors, you must change the high-order bit of its 
byte, which affects the cofors of aJI seven dots controlled by the 
byte. 

In other words, high-resolution graphics displayed on a color 
monitor or television set are made up of colored dots, according 
to the following rules: 

• Dots in even columns can be biack. purple, or blue. 

• Dots in odd columns can be black, green, or orange. 

• If adjacent dots in a row are both on, they are both white. 

• The colors In each row of seven dots controlled by a single 
byte are either purple and green, or blue and orange, 
depending on whether the high-order bit is off (0) or on (1). 

These rules are summarised in Table 2-8, The blacks and whites 
are numbered to remind you that the high-order bit is different. 





Bit 7 Off 


Bit 7 On 


AdjacenI columns off 


Black 1 


Black 2 


Even columns on 


Pjrple 


BJne 


Odd columns on 


Green 


Orange 


Adjacent columns on 


While 1 


White 2 



The peculiar behavior of the high-resolution colors reflects the 
way NTSC color television works. The dots that make up the 
Apple lie video signal are spaced to coincide with the frequency 
of the color subcarrier used in the NTSC system. Alternating 
black and white dots at this spacing cause a color monitor or TV 
set to produce color, but two or more white dots together do not. 
For more details about the way the Apple He produces color on a 
TV set, see Chapter 7. For information about the way NTSC 
color television works, see the magazine articles listed in the 
bibliography. 
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Display Pages 

The Apple Me generates its video displays using data stored In 
specific areas in memory. These areas, called display pages, 
serve as buffers where your programs can put data to be 
displayed. Each byte in a display buffer controls an object at a 
certain location on the display. In text mode, the obiect is a 
single character; in low-resolution graphics, the object is two 
slacked colored blocks; and in high-resolution mode, it is a line 
of seven adjacent dots. 

The 40-column-text and low-resofutSon-graphics modes use two 
display pages of 1024 bytes each. These are called text Page 1 
and Text Page 2. and they are located ati 024''£0'i7 (hexadecimal 
*400-47FF) and 20*^9-30 71 {*aDO " *BFF)in main memory . Normally, 
only Page 1 is used, but you can put text or graphics data into 
Page 2 and swilqh displays instantly. Either page can be 
displayed as 40-;column text, low- resolution graphics, or mixed- 
mode (four rows of text at the bottom of a graphics dispfay). 

The 80-column text mode displays twice as much data as the 
40-coEijmn mode — 1920 bytes — but it cannot switch pages. The 
eo-cotumn text display uses a combination page made up of text 
Page 1 in main memory plus another page in auxiliary memory 
located on the 80-column text card. This additional memory is NOT 
the same as text Page 2 — in fact, it occupies the same address 
space as text Page 1, and there is a special soft switch that enables 
you to store data into it (see the section "Display Mode Switching \ 
below). The built-in firmware I/O routines described in Chapter 3 
take care of this extra addressing automaliically; that is one reason 
to use those routines for ali your normal text output 

The high-resolution graptilcs mode also has two display pages, 
but each page is 8192 bytes long. In the 40 column text and low- 
resolution graphics modes each byte controls a display area 
seven dots wide by eight dots high. In high-resolution graphics 
mode each byte controls an area seven dots wide by one dot 
high. Thus, a high resolution display requires eight times as 
much data storage, as shown in Table 2-9. 
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Table 2-9 Video Display Page 
Locations 



*Nol@: SO-^ialuinn mode uses Ihe 
1024-byte page-i locations in both 
mam and auxiliary memory. The 
PAGE^ swilch is used to seleci one 
or the othef lor sionng data {see tlie 
section "Display Mode Switching''^. 



Display mode 



4&-column Texl, 

Low-resDlution 

Graphics 



BO-oolumn Text 



High-resolution 
Graphics 



Page 



Lowest 
Address 



1 

2 



t400 1024 



14 DQ 



^ Q24 



«£Q00 

*4QO0 16384 



Higtiest 
Addfeas 



*7FF 2047 
*BFF 3071 



»7FF 3047 



*3FFF 16383 



Dispiay Mode Switching 

You select the display mode that is appropriate for your 
application by reading or writing to a reserved memory location 
called a soft switch. In the Apple lie, most soft switches have 
three memory locations reserved for them: one for turning the 
switch on, one for turning it off, and one for reading the cuirent 
state of the switch, 

TabJe 2-10 shows the reserved locations for the soft switches 
that control the different display modes. For example, to switch 
fn?m mixed-mode to full-screen graphics in an assembly-language 
program, you could use the Instruction: 

STA tC05£ 

To do this in a BASIC program, you could use the instruction: 

POKE 49^34,0 

The table gives the switch locations in three forms: hexadecimal, 
decimal, and negative decimaf. You can use the hexadecimal 
values in your machine-language programs. Use the decimal 
values in peek or poke commands in Applesoft BASIC: the 
negative values are for Integer BASfC. 

You may not need to deal with these functions by reading and 
writing directly to the memory locations in this table. Many of the 
functions shown here are selected automaiically if you use the 
dispiay routines in the various high-tevel languages on the Apple lie. 
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Some of Ihe soft switches in Table 2-10 are marked read or 
write. Those soft switches share their locations with the keyboard 
data and strobe functions. In the ohgifnal Apple II. memory 
locations from *CO0 to*COl F {49iS2 to 431 83) were used only for 
the keyboard data and strobe functions. In the Apple lie, these 
locations are used the same way, but only when you read to get 
data and write to clear the strobe. To perform the function shown 
in the table, use the operation listed there, Soft switches that are 
not marked may be accessed by either a read or a write. When 
writing to a soft switch, it doesn't matter what value you write; 
the action occurs when you address the location, and the value 
\s ignored. 



Table 2-10 Display Soft Switches 

(1) This mode is only effective wtien 
graphics-mode swilcli is OU. 

(2) Tiiis- swilch lias a ditferenl lunctton 
when the flO'caluinn lexl card's 
auKLliary text pag^ is enabled: for 
lArnting. Refer to the next seclioii, 
"Addressing Display Pages Dpreclly". 

(3) This switch changes the lunclio^n of 
the PAGE 2 switch for addressing the 
auxiliary text memorv on the exlended 
BO-column text card, The next section 
describes how to do this. 

(4) Reading thfs location returns the 
Stale Of the venical blanking 
signal VHL . The function ot VBL is 
described in Chapter 7 in the section 
"Video Output Signals," 



Name 



Function 



Hex 



Location 
Decimal 



fiLTCHARSET 



TEXT 



MIXED 



Alternate char, set on 
Alternate char, set off 
Read ALTCHflRSET switch 



Text mode on 

Text mode off {graphics) 

Read TEXT Switch 



Mixed-mode on 
Mixed-mode off 
Read Ml )(£D switch 



PAGEE Page 2 on 

Page 2 ofl {Page 1 ) 
Read PAGE 12 switch 



Notes 



»COQF 49167 -16369 Write 
*CO0E 4316G -16370 Write 
iCOiE 49162 -1G3S4 Read 



*CCS1 49^33 -1B3D3 
ICDSD 49232 -16304 
•COIfl 49t7B -16358 Read 



»C053 4923B -16301 1 
•C052 49234 -163C^^ 1 
*C01H 49173 -163S7 Read 



1CDS5 43237 -16399 2 
IC054 49236 -16300 2 
*C01C 49teO -1G356 Read 



H I RES Hi-res mode on 

Hi-res mode OR 
Read HI RES switch 

BOCDL 0D-colJmn display on 

BD-columr display off 
Read socuL switch 



SOSTaRE Store in auxiliary memorv 
Store in main memory 
Read 8QSTDRE switch 



IC057 49239 -16297 1 

«C(}S6 49238 -16236 1 

•C01 D 491 81 - 1 6355 Read 

*CO0D 49165 16371 Write 

»CO0C 491G4 -16372 Write 

•COIF 49183 -16353 Read 



ICOOl 49153 -16383 W rile. 3 
»C0Oa 49152 -16384 Write, 3 
tCOlS 49176 -16360 HeaO 



Read vertical blanking 



•C019 49177 -163S9 



14 
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Any time you read a soft switch, you get a byte of dala. 
However, the only information the byte contains is the state of 
the switch, and this occupies only one bit — bit 7, the high-order 
bit. The other bits in the byte are unpredictable. If you are 
programming in machine language, the switch setting is the sign 
bit; as soon as you read the byte, you can do a Branch Pius if 
the switch is off, or Branch Minus it Ihe switch if on. 

If you read a soft-switch from a BASIC program, you get a value 
between and 255. Bit 7 has a vaiue of 128. so if the switch is 
on. the vaiue will he equal to or gr&ater than 128; if the switch is 
off, the value will be less than 128- 

Addressing Dispiay Pages Directty 

Before you decide to use the display pages directly, consider the 
alternatives. Most high lewel languages enable you to write 
statements that control the te>tt and graphics displays. Similarly, if 
you are programming ;in assembly language, you may be able to 
use the display features of the built-in I/O firmware, Vou should 
store directly into display memory only if the existing programs 
can't meet your requirements. 

The dfspJay memory maps are shown in Figures 2-5, 2-6. 2-7, 
and 2 8. All of the different display modes use the same basic 
addressing scheme: characters or graphics bytes are stored as 
rows of 40 contiguous bytes, but the rows themselves are not 
stored at locations corresponding to their locations on the display. 
Instead, the display address is transformed so that three rows 
that are etght rows apart on the display are grouped together and 
stored in the first 12Q locations of each block of 128 bytes {$80 
hexadecimal). By folding the dispiay data into memory this way, 
the Apple Me, like the Apple II. stores afl 960 characters of 
displayed text within 1 K bytes of memory. For a full description of 
the way the Apple lie handles its display memory, refer to the 
section "Display Memory Addressing" in Chapter 7. 

The high-resolution graphics display Is stored in much the same 
way as text, but there are eight times as many bytes to store, 
because eight rows of dots occupy the same space on the 
display as one row of characters. The subset consistmg of all the 
first rows from the groups of eight is stored in the first 1024 
bytes of the high-resolution display page. The subset consisting 
of ail the second rows from the groups of eight is stored in the 
second 1024 bytes, and so on for a total of 8 times 1024. or 
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8192 bytes- In other words, each bJock of 1024 bytes in the high- 
resolution display page contains one row of dots out of every 
group of eight rows. The individual rows are stored in sets of 
three forty-byte rows, the same way as the text display. 

All of the display modes except SO-column mode can use efther 
of two display pages. The display maps show addresses only for 
each Page 1 To obtain addresses for text or low-resoiution 
graphics Page 2. add 1024 (S400); to obtain addresses for high- 
resolution Page 2, add 8192 ($2000). 

The ao-coiumn display works a little differently. Half of the data is 
stored in the normal text Page-1 memory, and the other haJt is 
stored in memory on the 80-cotumn text card usfng the same 
addresses. The display circuitry fetches bytes from these two 
memory areas simultaneously and displays them sequentially: 
first the byte from the 80-column text card memory, then the byte 
from the main memory. The main memory stores the characters 
in the odd columns of the display, and the BO-column text card 
memory stores the characters in the even columns. 

To store display data on the 80-column text card, first turn on the 
80 STORE Softswitch by writing to location 491 53 (hexadecimaHCOOi 
or complementary -1 G383). WithaoSTORE on. the page-select switch 
PAGEP selects between the portion of the 80-column display stored 
tn Page 1 ot main memory and the portion stored in the 80- 
column text card memory. To seiect the 80-column text card, turn 
the Pft&E2 soft switch on by reading or wnting at location 49237. 
For more details about the way the displays are generated, see 
Chapter 7, 
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Rgure 2-S Map of 40-column Text 
Display 
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Rgure 2-6 Map of fiO-CQlumn Text 
Display 
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Figure 2-7 Map of Low-rBSQluMon 

Graphics Dispia^ 
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Figure Z-B Map ot Higli-resolution 

Graphics Display 
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in addition lo the primary I/O devices — the keyboard and 
display — there are several secondary input and output devices 
in the Apple lie. These devices are 

The speaker (output) 
Cassette input and output 
Annunciator outputs 
Strobe output 
Switch inputs 

Analog (hand control) inputs ^ 

These devices are similar in operation to the soft switches 
described in the previous section: you control them by reading or 
writing to dedicated memory locations. Action takes place any 
lime your program reads or writes to one of these locatfons; 
information written is ignored. 

Sonne of these devices toggle — change state — each time they 
are accessed. If you write using an indexed store operation, the 
Apple lie's 6502 microprocessor sctivates the address bus twice 
during successive ciock cycles, causing a device that toggles each 
time it is addressed to end up back in its original stale. For this 
reason, you should read, rather than write, to such devices. 



The Speaker 

The Apple lie has a small speaker mounted toward the front of 
the bottom plate. The speaker is connected to a soft switch that 
toggles: it has two states, off and on. and IX changes from one to 
the other each time it is accessed. Electrical specifications of the 
speaker circuit appear in Chapter 7, 

If you switch the speaker once, it emits a click; to make longer 
sounds, you access the speaker repeatedly. Vou should always 
use a read operation to toggle the speaker, If you write to this 
soft switch, it switches twice in rapid succession. The resulting 
pulse is so short that the speaker doesn't have time to respond; 
it doesn't make a sound. 

The soft switch for the speaker uses memory location a22Q0 
(hexadecimal *ca30). From Integer BASIC, use the complementary 
address -16336. You can make various tones and buzzes with the 
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speaker by using combinations of liming loops in your program. 
There is also a routine in the built-in firmware to make a beep 
tlirough the speaker. This routine is called BELLI ; it is described in 
Append! C. 



Cassette Input and Output 

There are two miniature phone jacks on the back panel of the 
Apple lie. You can use a pair of standard cables with miniature 
phone plugs to conned an ordinary cassette tape recorder to the 
Apple lie and save programs and data on audio cassettes. 

The phone jack marked with a picture of an arrow pointing 
towards a cassette is the output jack. It is connected to a toggled 
soft switch, like the speaker switch described above. The signal 
at the phone jack switches tram zero to 25 millivolts or from 26 
milltvoits to zero each time you access the soft switch. Detailed 
electrical specifications for the cassette input and output are 
given in Chapter 7. 

If you connect a cable from this jack to the microphone input of a 
cassette tape recorder and switch the recorder to record mode, ' 

the signai changes you produce by accessing this soft switch will 

be recorded on the tape. The cassette output switch uses ^ ^ 

memory location 49184 (hexadecimal tCOsO; complementary value 
-1 635E). Like the speaker, this output will toggle twice if you write 
to it, so you should onty use read operations to control the 
cassette output. ' 

The standard method for writing computer data on audio tapes 
uses tones with two different pitches to represent the binary 
states zero and one. To store data, you convert the data into a 
stream of bits, and convert the bits into the appropriate tones. To 
save you the trouble of actually programming the tones, and to 
ensure consistency among all Apple II cassette tapes, there is a 
buiit-in routine for producing cassette data output. This routine, 
called WRITE, is described in Appendix C. 

The phone jack marked with a picture of an arrow coming from a 
cassette is the input jack. It accepts a cable from the cassette 
recorder s earphone jack. The signal from the cassette is 1 volt 
(peak-to-peak) audio. Each time the instantaneous value of this 
audio Signal changes from positive to negative, or vice-versa, the 
state of the cassette input circuit changes from zero to one or 
vice-versa. You can read the state of this circuit at memory 
location 49£'48 (hexadecimal SCOGO, or complementary decimal 
-16268). 
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When you read this location, you get a byte, but only the high- 
order bit (bit 7) is valid. If you are programming In machine 
language, this Is the sign bit, so you can perform a Branch Plus 
or Branch Minus Immediately after reading this byte. BASIC is 
too slow to keep up with the audio tones used for data recording 
on tape, but you don t need to write the program: there is a built- 
in routine for reading data from a cassette. It is called READ, and it 
Is described In Appendix C. 

The Hand Conirof Connector Signals 

Several inputs are available on a 9-pin D-type miniature 
connector on the back of the Apple lie: three one bit inputs, or 
switches, and four analog inputs. These signals are also 
available on the sixteen-pin IC connector on the main circuit 
board, along with four one-bit outputsBnd a data strobe. You can 
access all of these signals from your programs. 

Ordinarily, you connect a pair of hand controls to the 9-pin 
connector. The rotary controls use two analog inputs, and the 
push-buttons use two one-bit inputs. However, you can also use 
these inputs and outputs for many other jobs. For example, two 
analog inputs can be used with a two axis joystick. Complete 
electrical specifications of these Inputs and outputs are given in 
Chapter 7; Table 7-18 shows the connector pin numbers. 

Annunciator Outputs 

The tour one-bit outputs are called annuncfators. Each 
annunciator can be used to turn a lamp, a relay, or some similar 
eiectronic device on and off. For electrical specifications of the 
annunciator outputs, refer to Chapter 7. 

Each annunciator Is controlled by a soft switch, and each switch 
uses a pair of memory locations. These memory locations are 
shown in Table 2-11. Any reference to the first location of a pair 
turns the corresponding annunciator off; a reference to the 
second location turns the annunciator on. There is no way to 
read the state of an annunciator. 
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Table 2-1 1 Ann jnciator Memory 
Locations 



Annunciator 
No. Pin' State 



Address 
Decimal Hex 



"Pin numbers given are for the t6-pin 

IC connector on the circuit board. 15 off ^Q^-iO -163S6 *C05B 

on 492^1 -16.29S 4C059 



1 14 off 49£^2 -16294 «C05ft 

on 49243 1C05B 



2 13 Off 49244 1 6292 1 C 05C 

on 4924B -16291 *C05D 



3 12 off 49?46 -16S90 *C05E 

on 49247 - 1 62S9 «C05F 



Strobe Output 

The strobe output is normally at +5 volts, but it drops to zero for 
aboul half a microsecond any time its dedicated memtpry location 
is accessed. You can use this signal to control functiohs such as 
data latching in external devices. If you use this signal, 
remember that memory is addressed twice by a write; if you 
need only a single pulse, use a read operation to activate the 
strobe. The memory iocation for the strobe signal is 4921 6 
(hexadecimal iC040 or complementary -16320). 

Switch inputs 

The three one-bit inputs can be connected to the output of 
another electronic device or to a pushbutton. When you read a 
byte from one of these locations, only the high order bit — bit 
7 — is valid information; the rest of the byte is undefined From 
machine language, you can do a Branch Plus or Branch Minus 
on the state of bit 7. From BASIC, you read the switch with a 
PEEK and compare the value with 128. If the value is 128 or 
greater, the switch is on. 

The memory locations for these switches are 492^9 through 
49251 (hexadecimal tcoei through »C063, orcomplementary 
-16287 through -16265). as shown in Table 2- 12, Switch 
and s witch 1 are permanently connected to the I open-apple 1 and 
Lsoli d-appleI keys on the keyboard; these are the ones normally 
connected to the buttons on the hand controls. Some software 
for the older models of the Apple II uses the third switch, switch 
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2p as a way of detecting the shift l<ey. This technique requires a 
hardware modification known as the single-wire shift-key mod. 



To perform this modification on your Apple We, all you have to do is 
solder across the broken circle labelled xe on the main circuit board- 
Early production Apple lies, idenlifled by a circuit board part number 
ending in A, have the shift-key mod active; you can remove it by 
breaking the circuit a1 xe Remember to turn off the power before 
clianging anything inside the Apple He, Also remember that changes 
such as this are at your own risk and may void the warranty. 




If you make the shifl-key modification and connect a joystick or 
other hand control that uses switch^ you must be careful never to 
close the switch and press the [SHlFf| key at the same time: doing 
this produces a short circuit that causes the power supply to turn 
off. When this happens, any programs or data in the computer's 
internal memory are lost. 



Analog Inputs ^ 

The four analog inputs are designed for use with 150K ohm 
variable resistors or potentiometers. The variable resistance is 
connected between the +5V supply and each input, so that it 
makes up part of a timing circuit (refer to Chapter 7 for details). 
The circuit changes state when its time constant has elapsed, 
and the time constant varies as the resistance varies. Your 
program can measure this time by counting in a loop until the 
circuit changes state, or times out. 

Before a program can read the analog inputs, it must first reset 
the timing circuits. Accessing memory location 49£64 (hexadecimal 
ICQ70 or complementary -1B2 72) does this. As soon as you reset 
the timing circuits, the high bits of the bytes at locations 49252 
through ^9£5S (hexadecimal *C064 through *C067 or complementary 
-1 6284 through -1 6281 ) are set to one. If you peek at them from 
BASIC, the values will be 12B or greater Within about 3 
milliseconds, these bits will change back to zero — byte values 
less than 128 — and remain there until you reset the timing 
circuits again. The exact time each of the four bits remains high 
is directly proportional to the resistance connected to the 
corresponding input. If these inputs are open — no resistances 
are connected — the corresponding bits may remain high 
indefinitely. 

To read the analog inputs Irom machine language, you can use 
a program loop that resets the timers and then increments a 
counter until the bit at the appropriate memory location changes 
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Table 2-12 Secondary i/0 Memorv 
Locations 

For connector idertificaliDn and pin 
numbers, refer to Tables 7-17 and 

7-1 a. 



to zero, or you can use the built-in routine. It is called PREflD, and 
it is described in Appendix C BASIC and otiier high-level 
languages atso include convenient means of reading the analOQ 
inputs: refer to your language manuals. 

Summary of Secondary UO Locations 

Table 2-12 shows the memorv locatlans for all of the built-in i/O 
devices except the keyboard and display. As explained above, 
some soft switches should only be accessed by means of read 
operations; those switches are marked. 



Function 



Address 
Decimal Hex 



Notes 



Speaker 




49£00 


-16336 


tC030 


Read 


Cassette Oul 






-16352 


*C020 


Read 


Cassette In 




49248 


- T 6205 


tCOGD 


Read 


Annunciator On 




492 41 


-16295 


IC0S9 




Annunciator Off 




4924 


-i62ae 


tC058 




Annjnciator 1 On 




4924 3 


-1 S233 


SCOSB. 




Annjnciator 1 Olf 




492«l£ 


-16294 






Annunciator 2 On 




49245 


^6291 






Annuncia!or2 Off 




49244 


-16292 


tcosc 




Annunciator 3 On 




49247 


-1G2S9 


*COBF 




Annunciator 3 Off 




4924G 


1629D 


SCOSE 




Strobe Output 




4921 E 


16320 


«CD40 


Read 


Switch Input a 




49249 


16287 


»C061 


Read 


i |dpen-apple| 


key) 










Swiicfi Input 1 




^925 


-16266 


«CD62 


Read 


(rSQUD-APPLE 












Swflch Input 2 




492S1 


- 1 S2B5 


*coe3 


Read 


Analog Input Reset 




49264 


- 1 6272 


*C070 




Analog Input 




49252 


1&284 


*CC64 


Read 


Analog Input 1 




492B3 




IC06S 


Read 


Analog Inpul 2 




4925 4 


-16282 


tC066 


Read 


Analog Input 3 




4925S 


1 &2S1 


tC067 


Read 



&2 

'A 
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The Monitor, or S/st&m Monitor, is a 
compulof progrEm tliat is used to 
operate the computer al Ihe machine 
level 



Table 3-1 Standard 1^0 Subroutines 



Chapter 3 
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Afmost every program on the Apple Me takes input from the 
keyboard and sends output to the display- The Monitor and the 
Applesoft and Integer BASICS do this by means of standard I/O 
subroutines that are built into the Apple lie s firmware. Many 
applications programs also use the standard I/O subroutines, but 
programs written in Pascal do not; Pascal has its own I/O 
subroutines. 

This chapter describes the features of these subroutines as they 
are used by the Monitor and by the BASIC interpreters, and tells 
you how to use the standard subroutines in your assembly- 
language programs. 

High-level languages already include convenient methods for 
handling most of the funclians described in this chapter. You should 
not need to use the standard I/O subroutines in your programs 
unless you are programming in assembly language. 



Subroutine 
Name 



LocaUon 



[}«&cr[ption 



COUT 

KEV IN 

GETLN 



»FDED 
tFDQC 

JFDIB 
tFDGfl 



Character Out: sends a character to the display. 

Read Key; displays ihe blinking cursor; goes to llie 
standard input routine, normally <EV IN. 

Key In: with SO-column firmware active, displays 
checkerboard cursor. Accepts a character Irom the 
keyboard. 

Gel Lirei drsplays the prompt character; accepis a 
sequence of characters by means oi RDKEiY. 
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The standard I/O subroutrnes listed in Table 3-1 are fully 
described in Ihis chapter. The Apple Jle ffrmware also contains 
many other subroutines that you might find useful. Those 
subroutines are deschbed in Appendix C Two ol the built-in 
subroutines, AUxnOVE and XFER^ can help you use the optional 
auxiliary memory; those subroutines are described in Chapter 4. 

Using the 110 SubroutitiBS 

Before you use the standard I'O subroutines, you should 
understand a little about the way they are used. The Apple He 
firmware operates differently with different options such as the 
80'Cofumn text card. This section describes general situations 
that affect the operation of the standard I/O subroutines. Specific 
instances are described in the sections devoted to the individual 
subroutines. 

Appte U CompatibiUty 

Compared to older Apple II models, the Apple lie has some 
additional keyboard and display features. To run programs that 
were written for the older models, you can make the Apple lie 
resemble an Apple II Plus by turning those features off. The 
features that you can turn off and on to put the Apple lie into and 
out of Apple II mode are listed in Table 3-2. 



J 

I 

i 



Table 3-2 Apple fl Mode 



Apple Me 



Apple II Mode 



Keyboard: Uppercase and lowercase Uppercase only 

Display Cfiaraclers: Inverse and norniat only 



Display size: 



40-corumn; also 
80-column, with op^onal 
card 



Flashing, inverse, and 
normal 

40-column only 



44 



If the Apple He does not have an BO-column text card installed in 
the auxiliary slot, it is almost in Apple II mode as soon as you 
turn it on or reset it. One exception is the keyboard, which is 
both uppercase and lowercase To be cornpatible with older 
software, you have to switch the Apple lie keyboard to uppercase 
by pressing the [ cftPS lock ] key. 
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statements in App lesoft a nd Int eger BASIC must be typed In 
uppercase letters. | cftPS l dckH will take care of this, but It makes It 
inconvenient to use lowercase letters in PRINT statements. If the 
BO-column firmware is active (see below), you can use 
uppercase- rest rid mode, which forces typed letters to uppercase 
except inside quotation marks (see Table 3-6). 

Another feature ttiat is different on the Apple lie is thie displayed 
character set. Older Apple Its display only uppercase characters, 
but they display them three ways: normaL inverse, and flashing. 
The Apple He can display uppercase characters all three ways, 
and it can display lowercase characters in the normal way. This 
combination is called the primary character set. When the 
Apple lie is first turned on or reset, it displays the primary 
character set 

The Apple lie has another character set, called the alternate 
character set, that displays a full set of normal and inverse 
uppercase and lowercase characters^ but can't display flashing 
characters. The primary and alternate character sets are 
described in Chapter 2 You can switch character sets at any 
time by means of the ALTCHARSET soft switch, also described in 
Chapter 2. 

The 80~coliimn Firmware 

There are a few features that are normally available only with the 
optional eO-column display. These features are identified in 
Tables 3-3a and 3-3b and Table 3-6. The firmware that supports 
these features is built into the Apple lie, but it is normally active 
only if an 80-column text card is installed in the auxiliary slot. 

When you turn on power or reset the Apple Me, the 80-co3umn 
firmware is inactive and the Apple lie displays th© primary 
character set, even if an 80-column text card is installed. When 
you activate the 80-cDlumn firmware as descnbed below, it 
switches to the alternate character set. 

The built-in eO-column firmware is implemented as if it were 
installed in expansion slot 3- Programs written for older Apple Ms 
with eo-cotumn display cards installed in siot 3 will run properly 
on an Apple Me with an 80-column text card. 
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If Ihe Apple Me has an 80-column text card and you want to use 
the eO-column display, you can activate the built-in firmware from 
BASIC by typing 

PR' 3 

To act ivate ttie eo -column firmware from the Monitor, type 3 and 
press [ control] -P. Notice that this is the same procedure you 
use to activate a card in expansion slot 3 Any auxiliary card 
installed in the auxiliary slot takes precedence over a card 
installed in expansion slot 3: see the section "Switching I/O 
Memory" in Chapter 6 for details. 

Eyen though you activated the BO-column fimiware by typing pr'3, 
you should never deactivate It by typing pr*0, because ttiat Just 
disconnects the firmware, leaving several soft swi tches still set for 
ao-CQlumn operation. Instead, type the sequence | ESC | [ CDNTRDL~[ -Q 
{see Table 3-6). 

If there is no 80-column text card in your Apple lie, you can still 
activate the BO-column firmware and use it with a 40-column 
display. First, set the IKTC3R0K soft-switch located at 
*COOA (19162); this switch is described in Chapter 6 in the section 
"Switching I/O Memory". Then type PR'3 to transfer control to the 
firmware. 

When the BO-column firmware is active without a card in the 
auxiliary slol, it does not work quite the same as it does with a 
card. The functions that cfear the display (CLREOL, cledlz. 
CLREOP, and HunE] work as if the firmware were inactive: they 
always clear to blacks even in inverse format. Also, interrupts are 
locked out throughout long operations such as clearing the 
display. With a card installedK the firmware enables interrupts 
periodically during these long operations. 



Warning 

If you do not have either an SO-column text card in the auxiliary slot 
or a terminal card of some kind in expansion slot 3, don't try to 
activate the firmware by simply typtng pr'3, Typing PR '3 with no card 
installed transfers control to the empty connector, with unpredictable 

results, 



Programs activate the SO-column firmware by transferring controi 
to address *C3Q0. If (here is no card in the auxiliary slot, you must 
set the lNTC3RQn soft switch first. To deactivate the eo-column 
firmware from a program, write a [ CQMTRDlI -u character via 
subroutine COUT. 
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The Old Monitor 

The older model Apple lis and Apple il Pluses included a different 
version of the System Monitor. It had the same standard ilO 
subroutines, but a few of their features were different: for 
example, there were no arrow keys for cursor motion. When you 
start the Apple lie with a DOS or BASIC disk and it loads Integer 
BASIC into the bank-switched area in RAM. it loads the old 
Monitor (sometimes called the Autostart Monitor) along with it. 
When you type INT from Appiesoft to activate Integer BASIC, you 
also activate this copy d( the old Monitor, which remains active 
until you either type fp to switch back to Applesoft, which uses 
the new Monitor in ROM, or type 

PR#3 

to activate the 80-column firmware. Part of the firmware's 
initialization procedure checks to see which version of the 
Monitor is in RAM. If it finds the oid Monitor, it replaces it with a 
copy of the new Monitor from ROM. After the firmware has 
copied the new Monitor into RAM, it remains there until the next 
lime you start up the system. 



The Standard 110 Links 

When you call one of the character I/O subroutines (CQUT and 
RDKEY). the fiirst thing that happens is an indirect jump to an 
address stored in programmable memory. Memory locations used 
for transferring control to other subroutines are sometimes called 
vectors; in this manual, the locations used for transferring control 
to the 3/0 subroutines are called (he f/O links In a Apple He 
running without a Disk Operating System, each I/O link is 
normally the address of the body of the subroutine (CQUTi or 
KEVIN). If a Disk Operating System (DOS) is running, one or both 
of these links hold the addresses of the corresponding DOS I/O 
routines instead. {DOS maintains its own links to the standard 
I/O subroutines.) 

By calling the I/O subroutines that jump to the link addresses 
instead of calling the standard subroutines directly, you ensure 
that your program wiil work properly in conjunction with other 
software, such as DOS or a printer drfver, that changes one or 
both of the I/O links. For ihe purposes of this chapter, we shail 
assume that the I/O links contain the addresses of the standard 
I/O subroutines COUTi and KEvtH, For more information about the 
I/O links, see the section "Changing the Standard I/O Links'" in 
Chapter 6. 
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Table 3.3a Control Characters with 

CDUT1 . 

(1 1 Only available when SO-columr 
fiprnwafe is active. 

(2) Only iworks from the keyboard . 

(3) Doesn t work from the keyboard. 



4S 



Standard Output Features 

The standard output routine is named CDUT, pronounced C-out, 
which stands tor character out. cauT normally calls CDUTi , which 
sends one character to the display, advances the cursor position, 
and scrolls the display when necessary. cOUTi restricts its use of 
the display to an active area called the text window, described 
below. 



COUT Output Subroutine 



Your program makes a subroutine call to *fdED with a character 
in the accumulator CQUT then passes control via the output link 
CSW to the current output, normally cduti, which takes the 
character in the accumulator and writes it out. If the accumulator 



Control ASCII Apple lie Action 

Characler Nafn^ Name Taken by C0UT1 



Notes 



I CQMTROLJ - G 
fCCHTROL] - H 



[BEL), bell 



(B8} backspace 



I caNTRQLi - J tLF) line feed 



CONTROL - K 



fcQNTRaLj - L 



{VT) clear EOS 
j^FF) clear 



I CDNTROlI - M (CR) relurn 



I cdntrql| - D 



CONTROL - Q 



COMTROL - R 



CONTROL - S 



(50) normal 

(51) inverse 
(DCi) 4a-coiumn 
(DC2) SQ-column 
(DS3) stop-lisi 



Produces & 1000 Hz tone for 
0.1 second. 

Moves cursor position one 
space to the left: rrom left edge 
of window, moves to right end 
of line above- 
Moves cursor posilion down to 
next line in window; scrolls if 
needed 

Clears from cursor posiUon to 
the end of llie window- 
Moves cursor position to 
upper-letl comer of window and 
clears window. 

Moves cursor position to left 
end next line in window; 
scroiSs if needed. 

Sets display fonnat normal. 

Sets display fomat inverse. 

Seis display to 40-calumn. 

Sets display lo 90-cDtumn-l 



1,3 
1.3 
1 



Stops sending characters to I he 1,2 
display, until a hey is pressed. 
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Table 3-3b Control Characters wEth 
COUTi , continued 

(1 ) Cn\y available when 80-column 
ftrmware is active. 

(2) gotoXY is rol suppOTled under 
BASIC: see me Apple Pascal 
Operating System Refafence Manuat. 



contains an uppercase or lowercase letter, a number, or a 
speciai character, the accumulator contains a control character. 
CQUTi eittier performs one of the special functions described 
below or ignores tt;e character. 

Each time you send a character to coUTi , it displays the character 
at the current cursor position, replacing whatever was there, and 
then advances the cursor position one space to the right. If the 
cursor position is already at the right-hand edge of the window, 
CDUT1 moves it to (he left-most position on the next line down. If 
this would move the cursor position past the end of the last line 
in the window, couTi scrolls the display up one line and sets the 
cursor position at the left end of the new bottom line. 



Control 
Character 



ASCII Apple Jle 
Name Name 



Actiofi Taken by C0UT1 Notei 



[ CQMTBaLl - U (NAK) quit 



I CDHTROLt- V (SVNJ scroll 



I CDNTHOL J - W (ETB) serofl-up 



rCQNTBOLl - y (EM) tiome 



I COHTROLl - Z (SUB) Clear Ihe 



[caHTRDLl - ^ (FS) Iwd- 



jcQHTRDLl - f (G S ) clear EOL 



ICDHTHDLl - * (RS) gotoXY 



Deactivates flOcoJumn 
firmware, homes cursor, 
and dears screen, 

Scrol!ls the display down 
one line, leaving ttie cursor 
m the currenl position. 

Scrolls the display' up one 
line, leaving \he cursor In 
the current position. 

Moves cursor posrtton to 
upper-leu corner ol window 
(but doesn't clear). 

Clears the line ttie cursor 
posilion is ori- 

Moves cursor position one 
space to the right: from 
right edge of window, 
moues it to left end of lino 
below. 

Clea/5 ijne from cursor 
position to the right edge of 
the window. 

Using the next two 
characters, minus 32. as 
one Dyte X and Y values, 
moves the cursor position 
to CH = X, CV=Y. 
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TVie cursor position is controlled by the values in memory I 

locations 36 and 37 (hexadecimal »24 and *25). These locations ^ 

are named CH, for cursor horizontal, and CV. for cursor vertical. ^ 

C0UT1 does not display a cursor, but the input routines described I 

below do, and they use this cursor position. If some other routine ^ 
displays a cursor, it wilt not necessarily put it in the cursor 

position use d by COUTi . j 

Control Characters with CDUT1 

C0UT1 does not display control characters. Instead, ttie control J 
characters listed in Tables 3 3a and 3'3b are used to initiate ^ 
some action by the tirmware. Other control characters are — 
ignored. Most of the functions listed here can also be invoked 
from the keyboard, either by typing the control character listed or ^ 
by using the appropriate escape code, as described in the — 
section "Escape Codes with KEYIN' . The stop-list function, 
described separately, can only be invoked from the keyboard. 

The Stop'iist Feature 

When you are using any program that displays text via cOUTi , you \^ 

can make it stop updating the display by holding down the 

r cDNTROLl key and pressing the S i^ey. Whenever CDUTi gets a ^ 

carriage retu rn from the program, it checks to see if you have ^ 

typed a f caNTRDLl -S . !t you have, CDUTi stops and waits for you to 

press another key, When you want cOUTi to resume, press — 

another key; COUTi will send the carriage return it got earlier to ^ 

the display, then continue normally. The character code of the 

key you pressed to resume dis playing is i gnored unless it is a ^ 

r cDMTRDL> c COUTI passes rcDNtRDLl -c back to the program; if 

it is a BASIC program, Ihis enables you to terminate the program 

while in slop-list mode. ^ 



The Text Window 

After starting up the computer or after a reset COUTi uses the 
entire display. However, you can restrict CDUTi s activity to any 
rectangular portion of the display you wish. The active portion of 
the display is called the text window. COUTi puts characters only 
into the window; when it reaches the end of the last line in the 
window, it scrolls only the contents of the window. 
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You can set the top, bottom, left side, and width of the text 
window by storing the appropriate values into four locations in 
memory. This enables your programs to control the placement of 
text in the display and to protect other portions of the screen 
from being written over by new text. 

Memory location 32 (hexadecimal $20) contains the number of the 
leftmost column in the text window. This number is normafly 0. 
the number of the leftmost column in the display. In a 40-column 
display, the maximum value for this number is 39 {hexadecimal 
S27); in an SO-column display, the maximum value is 79 
(hexadecimal $4F). 

Memory location 33 (hexadecimal »£1 ) holds the width of the text 
window. For a 40-uolumn display, it is normally 40 (hexadecimal 
$28); for an 80-column display, it is normally 80 (hexadecimal 
$50). CDUTi truncates the width to an even value. 



Warning 

Be carefui not (0 tet the sum of the window width and the leftmost 
position in the window exceed the width of the d<splay you are using 
[40 gr 80). If thfs happens, it is possible for couti to pui characters 
into memory locations outside the display page, possibly destroying 

programs or data. 



Memory location 3A (hexadecimal t2£) contains the number of the 
top line of the text window. This is normally 0, the topmost line in 
the display. Its maximum value is 23 {hexadecimal $17). 

Memory location 3S {hexadecimal *23) contains the number of the 
bottom tine of the screen, plus 1. It is normally 24 (hexadecimal 
$18) (or the bottom line of the dispfay. Its minimum value is 1. 



Warning 

Any time you change the boundaries of the text window, you shoi/ld 
make sure thai the current cursor position (stored at ch and cv) is 
inside the new window. II it is outside, it is possible far cDUTi to put 
characters into memory locations outside the dispiay page, possibly 
destroying programs or data, 
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Table 3-4 Text Window Memory 
Locations 



Window 
Parameter 


Location 
Dec Hex 


Minimum 

Value; 
Dec Hex 


Norinel Values: 
40cD^ SCteoL 
Dec Hex Dec Hex 


Maximum Values; 
40coL BOcoF. 
Dec HeK Dec Hex 


Left Edge 


32 


t20 





$0 


□ 


$0 





$0 


39 


$27 


79 54F 


Width 


33 


t21 





$0 


40 




BO 


S50 


40 


$26 


ao S50 


Top Edge 


34 


*22 





so 





$0 





$0 


23 


$17 


23 $17 


Sottorrv Edge 


3& 


*23 


1 


SI 


24 


S1B 


24 


$ia 


24 


$18 


24 $ie 



Table 3-4 summarizes the memory locations and the possible 
values for the window parameters. 



Inverse and Flashing Text 

Subroutine CQUTi can display text in normal format, inverse 
format, or, with some restrictions, flashing format. The display 
format for any character in ttie display depends on two things: 
the character set being used at the moment, and the setting of 
the two high-order bits of the character's byte in the display 
memory. 

As it sends your text characters to the display^ coun sets the 
high-order bits according to the vaiue stored at memory iocation 
50 (hexadecimal *3^), If that value is 255 (hexadecimal $FF), 
C0UT1 sets the characters to display in norma! format; if the value 
is 63 (hexadecimal $3F), couTi sets the characters to inverse 
format. If the value is 127 (hexadecimal $7F) and if you have 
selected the primary character set. the characters will be 
displayed in flashing format Note that flashing format is not 
available in the alternate character set. 

To control the display format of the characters, routine COUTi uses 
the value at iocation 50 as a logical mask to force the setting of 
the two high-order bits of each character byte it puts Into the 
display page. It does Ihts by performing the logical ftHD function 
on the data byte and the mask byte. The resuEl byte contains a 
in any bit that was in the mask. The version of couTi in the 80- 
coiumn firmware changes only the high-order bit of the data 



'i 



3 



a 

:j 



Built-in I/O Firmware 



l: 
l: 
l: 
l: 

l: 



L 
L 



Table 3.-5 Text Format Control Values 

Nole: These masK vatues apply only lo 
Ihe primary character set (see text)- 



Mask value 
Dec Hex 



Display form at 



255 SFF Normal, uppercase and towercase 

127 S7F Flashing, uppercaEe and symbols 

63 S3F Inverse^ uppercase and lowercase 



If tiiB 80-cx)lumn firmware is inactive and you store a rtiask value at 
locatian 50 with zeros in its low-order bits, cQUTi will mask out thtose 
bits in your teKt. As a result, some characters will be transformed 
into other characters. You should set the mask only to the values 
given in Table 3-5, 

If you set the mask value at location SO to 127 (hexadecimal 
S7F), the high-order bit of each result byte will be 0, and the 
characters will be displayed either as lowercase or as flashing, 
depending on which character set you have selected. Refer lo 
the tables of display character sets In Chapter 2. In the primary 
character set, the next-highest bit. bit 6. selects flashing forrrat 
with uppercase characters. With the primary character set you 
can display lowercase characters in normal format and uppercase 
characters in normal, inverse, and flashing formats. In the 
alternate character set, bit 6 selects lowercase or special 
characters With the alternate character set you can display 
uppercase and lowercase characters in normal and inverse 
formats. Switching between character sets is described in the 
section "Display Mode Switchtng" in Chapter 2. 

Standard Input Features 

The Apple He's firmware includes two different subroutines for 
reading from the keyboard One subroutine is named RDKEY, which 
stands for read key. It calls Ihe standard character input 
subroutine KEVIN, which accepts one character at a time from the 
keyboard. The other subroutine is named oetlH-, which stands for 
get line By making repeated calls to RDKEY. getln accepts a 
sequence of characters terminated with a carriage return. GETLN 
also provides on-screen editing features: see the section '^Editing 
with GETLN". 



Standard Input Features 



53 



RDKEY tnput Subroutine 

A program gets a character from the keyboard by making a 
subroutine call to rdkey at memory location sfdoc. rdkev sets the 
character at the cursor position to flash, then passes control via 
the input link ksw to the current input subroutine, which Is 
normally KEVIN. 



The method RDKEv uses to display a cursor works as it did on the 
older modeJ Appfe lis, which don't display lowercase characters. 
If you are running an integer BASIC program with the 80-column 
firmware inactive, the RDKEV-style cursor is still appropriate. With 
lowercase characters or with the alternate character set, this 
method of displaying a cursor is no longer satisfactory. 



RDKEY displays a cursor at the current cursor position, which is 
immediately to the right of whatever character you last sent to 
the display (normally by using the COUT routine, described above). 
The cursor displayed by RDKEV is a flashing version of whatever 
character happens to be at that position on the screen. It is 
usually a space, so the cursor appears as a blinking rectangle. 



KE Y I N Input Subroutine 

KEVIN is the standard input subroutine. When called, it waits until 
the user presses a key, then returns with the key code in the 
accumulator. 

The probfem of displaying a cursor without using flashing format 
is handled by keytn. if ihe 80-column firmware is inactive, KEY IN 
displays a cursor by alternately storing a checkerboard block *n 
the cursor focation, then storing the original character, then the 
checkerboard again, it the firmware is active, KEYIi^ displays a 
steady inverse space (rectangle), unless you are in escape 
mode, when it displays a plus sign ( + ) in inverse format, 
(Escape mode is described in the next section.) 

KEY IN also generates a random number. While it is waiting for the 
user to press a key, key in repeatedly increments the 16-bit 
number in memory locations 78 and 73 (hexadecimal *4E and *''F), 
This number keeps increasing from to 65535, then starts over 
again at 0. The value of this number changes so rapidly that 
there is no way to predict what it will be after a key is pressed. A 
program that reads from the keyboard can use this value as a 
random number or as a seed for a pseudo-random number 
routine. 
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Table 3HB Escape Codes 

{1 ) Old-style curBor-cortfol key: see 
texl. 

f2) CufSor-OOntrnJ key: see text 

(3) This code functions only when the 

80"Co]umn firmware is active. 



When the user presses a key, key IN accepts the character, stops 
displaying the cursor, and returns to the calling program with the 
character in the accumulator. 

Escape Codes with KEVIH 

KEVIN has many special functions that you invoke by typing 
escape code s on th e keyboard. An escape code is obtained by 
pressing the [ esc \ key, releasing it, and then pressing some 
other key, as shown in Table 3-6 . T he notation in the lable — 
i_ESCj ' — means press the [£5C J key, release it, then press the 
character that follows. 



Escape Code 



ESC @ 



ESC A 



ESC B 



[E SC J C 

[esc] D 



ESC E 



ESC F 



[ESC I 1 

L^scj I 

[ ESC I J 
I ESC 1 -^- 

[esc] < 
I ESC] -^ 

[ESC]( 



ESC R 



[ESC]T 



ESC 4 



ESC 3 



Function 



, ESC ] I CONTROL i -Q Deactivates the ao-colurrtn finnware 



Notes 



Clears Ihe window and homes the cursor 
Moves the cursor up one line 
Moves Ihe cursor right one space 
Moves the cursor left one s^ace 
Moves the cursor down one line 
Clears to the end of the Ipne 
Clears to the bottom of the windnw 

Moves the cursor up nne lire and (urns on 

escape mode 

Moves the cursor teft one space and turns on 
escape mode 

Moves the cursor right one space and turns on 
escape mode 

Moves the cursor down one line and turns on 
escape mode 

Tumg on restrJcted-case mode 

Turns off restrilcted-caBe mode 

Switches to 40-column mode, riomes the 
cursor, and ctears the screen 

Switches to BO-cotumn mode, homes ihe 
Cursor, and clears the screen 



3 

3 
3 
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Table 3-6 inclu des th ree sets of cursor-conlrol keys. The first set 
consists of the (_EScJ key followed by A, B, c, or D. The letter keys 
can be either uppercase or lowercase. These keys are the 
standard cursor-motion keys on older Apple II models: they are 
present on the Apple Ife primarily for compatability with programs 
written for old machines, 

Cursor Motion fn Escape Mode 

The second and third set of cursor-control keys are listed 
together because they activate escape mode. In escape mode. 
you ca n keep using the cursor-motion Keys without pressing the 
["esc I key again. This enables you to perform repeated cursor 
moves by holding down the appropriate key. 

When the SO-columr firmware is active, you can tell when key IN 
is in escape mode: it displays a plus sign In inverse format as 
the cursor. You leave escape mode by typing any key other than 
a cursor-motion key. 



The escape codes with the directional arrow keys are the 
standard cursor motion keys on the Apple He. The escape codes 
with the 1 , J, K, and n keys are the standard cursor-motion keys 
on the Apple II Plus, and are present on the Apple lie for 
compatability with the Apple II Plus. On the Apple lie, the escape Iji^^ 
codes with the 1 , J, K, and ri keys function wjth either uppercase 
or lowercase letters. 



GETLM Input Subroutine 

Programs often need strings of characters as input. While it is 
possible to call rdkey repeatedly to get several characters from 
the keyboard, there is a more powerful subroutine you can use. 
This routine is named getln, which stands for get line, and it 
stans at location $FD6A. Using repeated calls to RDkEV, getln 
accepts characters from the standard input subroutine — usually 
KEY IN — and puts them into the input buffer located in the 
memory page from *20D to *£FF. getln also provides the user with 
on-screen editing and control features, described below in the 
section Editing with &ETLN'". 

The first thing oeTln does when you call it is display a prompting 
character, called simply a prompt. The prompt indicates to the 
user that the program is waiting tor input. Different programs use 
different prompt characters, helping to remind the user which 
program is requesting the input. For example, an Input statement 
in a BASIC program dispEays a question mark ( ? ) as a prompt. 
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Table 3-7 Prompt Characters 
*Note; Mini -assembler is available only 
with Integ'Sr BASIC active. 



The prompt characters used by the different programs on the 
Apple He are shown in Table 3-7, 

GETLN uses the character stored at memory location (hexadecimal 
•33) as the prompt character. In an assembly-language program, 
you can change the prompt to any character you wish. In BASIC, 
changing the prompt character has no effect, because both 
BASIC interpreters and the Monitor restore it each time they 
request input from the user. 



Prompt 
Character 



Program Requesting input 



7 



Us&rs BASIC program {INPUT statement) 

Integer BASIC 

Applesoft BASIC 

Firmware Monitor 

Mini-assembler* 



As the user types the character string. GETLN sends each 
character to the standard output routine — normally cduti — 
wfiichi displays it at the previous cursor position and puts the 
cursor at the next available position on the display, usually 
immediately to the right As the cursor travels across the display, 
it indicates the position where the next character will be 
displayed. 

GETLN stores the characters in its buffer, starting at memory 
location *ZOO and using the X register to index the buffer. GETLN 
con tinues to a ccept and display characters until the user presses 
the I RETURN ] key; then it clears the remainder of the line the 
cursor is on, stores the carriage-return code in the buffer, sends 
the carriage- return code to the display, and returns to the calling 
program. 

The maximum line-length that GETLN can handle is 255 characters. 
If the user types more than this. GETLN sends a backslash ( \ )and 
a carriage return to the display, cancels the line It has accepted 
so far, and starts over. To warn the user that the line Is getting 
full, GETLN sounds a bell (tone) at every keypress after the 246th. 
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In Ihe Apple II and the Apple H Plus, the geTlh routine converts all 
inputs to upperease OETln in the Apple lie does not do this, even in 
Apple II mode. To gel uppercase input tor BASIC, use (he 

CAPS LOCK key or switch to restricted-case mode using the escape ' 
sequence shown in Table 3-6. With restricted-case acttve, ietters are 
automatically stiifted to uppercase except inside quotation marks. 



J 

Arty time you are typing a line, pressing I cdnTrQl \ -x causes 
GETLH to cancel the line, getlh displays a backslash ( / ) and 
issues a carnage return, then displays the prompt and waits for 
you to type a new line, getln takes the same actton when you 
type more than 255 characters, as described above. Hsf^ 



Editing with GETLN 

Subroutine getln provides the standard on-screen editing features 
used by the BASIC interpreters and the Monitor For an 
introduction to editing with these features, refer to the Applesoft 
Tutorial. Any program that uses GETLN for reading the keyboard 
has these features. 

Cancer Line 



getln picks up the character at the display position just as if it 
had been typed on the keyboard You can use this procedure to 
pick up characters that you have just deleted by backspacing 
across them- You can use the backspace and retype functions 
with the cursor-motion functions to edit data on the display {see 
the earlier section "Cursor Motion in Escape Mode"). 



When you press the | LEFl-ftRRDUi J key, getln moves its buffer 
pointer back one space, effectively deleting the last character in 
its buffer. It also sends a backspace character to routine COUT. 
which moves the display position and the cursor back one space. 
If you type another character now, it will replace the character 
you backspaced over, both on the display and in the !ine butler. 
Each time you press the | LEFT-ftRRUW ] key, it moves the cursor left — 
and deletes another character , until you re ach the beginning of 

the line. If you then press the [ LEFT-ARRm^l key one more time, 

you have effectively cancelled the line, and GETLN issues a — 
carriage return and displays the prompt. 

Retype ~* 

The [RiGHT- fl RRDliJ | key has a function that iscorriplernenlary to 



the backspace function. When you press the[ RIG HT-ARROm] key, 
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The Apple lie's 6502 microprocessor can address 65,536 {64K) 
memory locations (K stands for 1024; refer to the glossary). All of 
the Apple lie's programmable storage (RAM, for random-access 
memory), read-only storage (ROM, for read-only memory) and 
input and output devices are allocated locations in this 64K 
address space. Some functions share the same addresses — but 
not at The same time. For information about these shared 
address spaces, see the section '■8ank-switched Memory" in this 
chapter and the sections "Other Uses of I/O Memory Space" 
and "Expansion ROM Space" in Chapter 6. 

All input and output in the Apple lie is memory mapped. In this 
chapter, the I/O memory spaces are described simply as blocks 
of memory. For details of the built-in ly'O features, refer to the 
descriptions in Chapters 2 and 3. For information about I/O 
operations with peripheral cards, refer to Chapter 6, 

People often refer to the Apple lie s memory in 256-byle blocks 
called pages One reason for this is that a one-byte address 
counter or index register can specify one of 256 different 
locations. Thus, page consists of memory locations from to 
£55 (hexadecimal *0 to sff), incSusive. Page 1 consists of 
locations 2SS to 51 1 (hexadecimal J t QO to *i FF — note that the 
page number is the high-order part of the hexadecimal address). 
Don't confuse this kind of page with the display buffers in the 
Apple Jle, which are sometimes referred to as Page 1 and 
Page 2. 

Main Memory Map 

The map of the main memory address space in Figure 4-1 
shows the functions of the major areas of memory. For more 
details on the I/O space from to 52K {icooo through «cfff), 
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Figure 4-1 Bystem Memorv Map 



refer Id Chapter 2 and Chapter 6; the bank-switched memory in 
the memory space from 52K to 64K (SOOOO through *FFFF) is 
described below. 
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Figure 4-2 RAM Allocalion Map 
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BAM Memory Allocation 

As Figure 4-1 shows, the major portion of the Apple He's memory 
space is allocated to programmable storage (RAM). Figure 4-2 
shows the areas allocated to RAM. The main RAM memory 
extends from Jocation to location 491 51 (hex «bfff), and 
occupies pages through 191 (hexadecimal $BF). There is also 
RAM storage in the bank switched space from 53248 to G5535 
(hexadecimal *D00o to *ffff), described in a separate sectfon of 
this chapter, and au)<iliary RAM on the 80-column text card or the 
extended SO-column text card, described En Chapter 6 

Reserved Memory Pages 

Most of the Apple Ife's RAM is available for storing your 
programs and data. However, a few RAM pages are reserved for 
the use of the Monitor firmware and the BASIC interpreters. The 
reserved pages are described below. 

The system does not prevent your using these pages, but if you do 
use them, you must be careful not to disturb the system data they 
contain, or you will cause the system to malfunction. 
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Page Zero 

Several of the 6502 microprocessor's addressing modes require 
the use of addresses in page zero, also called zero page. The 
Monitor, the BASIC interpreters, and DOS all make extensive use 
of page zero. 

To use indirect addressing in your assembly-language programs, 
you must store base addresses in page zero. At the same time, 
you must avoid inteilering with the other programs that use page 
zero — the Monitor, the BAStC interpreters, and the Disk 
Operating Systems. One way to avoid conflicts is to use only 
those page-zero locations not already used by other programs. 
Tables 4-1 , 4-2, 4-3, and 4-4 show the locations in page zbto 
used by Ihe Monitor, Applesoft BASIC. Integer BASIC, and 
DOS 3,3. 

As you can see from the tables, page zero is pretty well used 
up, except for a few bytes here and there. It's hard to find more 
than one or two bytes that aren't used by either BASIC or the 
fylonttor or DOS. Rather than trying to squeeze your data into an 
unused corner you may prefer a safer alternative: save the 
contents of part of page zero, use that part, then restore the 
previous contents before you pass control to another program. 

The 6502 SUck 

The 6502 microprocessor uses page 1 as the stack — the place 
where subroutine return addresses are stored, in first-in, last-out 
sequence. Many programs also use the stack for temporary 
storage of the registers {via push and pull operations). You can 
do the same, but you should use \l sparingly. The stack pointer 
is eight bits long, so the stack can hold only 256 bytes of 
information at a time. When you store the 257th byte in the 
stack, the stack pointer repeats itself, or wraps around, so that 
the new byte replaces the first byte stored, which is now lost. 
This writing over old data is called stack overflow, and when it 
happens, the program continues to run normally until the lost 
information is needed, whereupon the program terminates 
catastrophicatly. 

The Input Buffer 

The GETLN input routine, which is used by the Monitor and the 
BASIC interpreters, uses page 2 as its keyboard-input buffer. 
The si^e of this buffer sets the maximum size of input strings. 
(Note; Applesoft only uses the first 237 bytes, although it permits 
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you to type all 256.) If you know that you won t be typfng any 
long Input strings, you can store temporary data at the upper end 
of page 2. 

Link-Address Storage 

The Monitor and DOS 3 3 both use the upper part of page 3 for 
link addresses or vectors. Table 4-10 shows the part of page 3 
the Monitor uses; refer to the DOS Manuaf to see how DOS 
uses page 3. 

BASIC programs sometimes need short machine-language 
routines. These routines are usuaHy stored in the lower part of 
page 3. 

ThB Dispiay Buffers 

The primary text and low-resolution-graphics display buffer 
occupies memory pages 4 through 7 (tocations i 024 through 2047. 
hexadecimal tO^OO through *a7FF). This entire 1024-byte area is 
called display Page 1 . and it is not usable for program and data 
storage. There are 64 locations in this area that are not 
displayed on the screen; these locations are reserved for use by 
the peripheral cards (see Chapter 6). 

Display Page 2, the alternate text and low-resolution-graphics 
display buffer, occupies memory pages 8 through 1 1 (locations 
2048 through 3Q7i , hexadecimal tOBOO through *obff). Most 
programs do not use Page 2 for displays, so they can use this 
area for program or data storage. 

The primary high-resoiution-graphlcs display buffer, called high- 
resolution Page 1 , occupies memory pages 32 through 63 
{locations ai9E through 16383, hexadecimal *£0 through 
t3FFF). If your program doesn't use high-resolution graphics, this 
area is usabie for programs or data. 

High-resotution-graphics Page 2 occupies memory pages 64 
through 95 (locations 1G3B4 through 2457s. hexadecimal «4000 
through *5FFF). Most programs use this area for program or data 
storage 

For more information about the display buffers, see Cfiapter2. 
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Table 4-3 Integer 8ASIC Zero=page High Nybble Low Nybble of Address 

Usage ofAddress to t^ I? t3 »4 tg te 17 «e t3 tA *S IC »D «E tF 



COD 
C1 

*40 
• SO 
«G0 

teo 

*90 

tco 

tDO 

«e:d 

*F0 



Table 4-4 DOS 3 3 ^aro-page Usage High Nybbte Low Nybble of Address 

of Addr«3fi 10 t1 12 t3 94 IG $6 »7 *B «9 «A »B «C «D SE tr 



too 

tl 

«3C) 
»40 
*50 

S8G 
tgo 

tBO 
*C0 

too 

*F0 
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Bank-switched Memory 

The memory address space from 52K to G^K (hexadecimal »dooo 
through *ffff) is doubly altocated: it is used for both ROM and 
RAM. The 12K bytes of ROM (read-only memory) in this address 
space contain the Monitor and the Applesoft BASIC interpreter. 
Alternatively, there are 16K bytes of RAM in (his space. The 
RAM is normally used for storing either the Integer BASIC 
interpreter or part of the Pascal Operating System (purchased 
separately). 

You may be wondering why this part of memory has such a split 
personality. Some of the reasons are historical: the Apple Me is 
able to run software written tor the Apple II and Apple II Plus 
because it uses this part of memory in the same way they do It 
is convenient to have the Applesoft fnlerpreter in ROM, but the 
Apple He, like an Apple II with a language card, is also able to 
use that address space for other things when Applesoft is not 
needed. 

You may also be wondering how 16K bytes of RAM is mapped 
into only 12K bytes of address space. The usual answer is that 
it's done with mirrors, and that isn't a bad analogy: the 4K-byte 
address space from 52 < toSGK (hexadecimal *D00 Q through »dfff) 
is used twice. 

Switching different blocks of memory into the same address 
space is called bank switching. There are actually two examples 
of bank-switching going on here: first, the entire address space 
from52K [oG^K {*DQOO through *FFFF)is switched between ROM 
and RAM, and second, the address space from S2K to s&K (*D0O0 
to SDFFF] is switched between two different blocks of RAM. 



Rgure 4-3 Bank-switched Memnxy Map pppp 
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You switch banks of memory \n Ihe same way you switch other 
functions in the Apple lie: by using soft switches. These soft 
switches do three things; select either RAM or ROM in this 
memory space; enable or inhibit writing to the RAM (write- 
protect), and select the first or second 4K-byte bank of RAM in 
the address space *D0O0 to *DFFF. 




Do noi use these switches wkhoul carefuJ planning. Careless 
switching between RAM and ROM is almost certain to have 
catastrophic effects on your programi. 



Table 4-5 shows the addresses of the soft switches for enabling 
all combinations of reading and writing in this memory space. All 
of the hexadecimal values of Ihe addresses are of the form * C08x 
Notice that several addresses perform the same function: this is 
because the soft switches are activated by combinations of 
address bits. For example^ any address of the fonr) scqsk with a 
1 in the low-order bit enables the RAM for writing, Similariy. bit 3 
of the address selects which 4K block ct RAM to use for the 
address space *Dooo-*dfff; if bit 3 is □, the first bank of RAM is 
used, and if bit 3 is 1 , the second bank is used. 



Table 4-5 Bank Select Swllcl^es 

(1) This switch write-enables RAM 
an<J read-erablea ROM. 

(2) Two Successive reads to this 
switch enables RAM bolh for reading 
and writing. 
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When RAM is not enabled for reading, the ROM in this address 
space is enabled. Even when RAM is not enabled for reading, it 
can still be written to if it is write-enabled. 

When you turn power on or reset the Apple lie, it initializes the 
bank switches for reading the ROM and writing the RAM, using 
the second bank of RAM. Note that this is different from the 
reset on the Apple II Plus, which didn't affect the bank-switched 
memory (the language card). On the Apple lie. you can't use the 
reset vector to return controi to a program in bank-switched 
memory, as you couid on the Apple 1) Plus. 

When you are using Integer BASIC on the Apple lie, reset works 
correctly, restarting BASIC with your program intact. This happens 
because the reset vector iransrers control to DOS, and DOS resets 
the switches for the current version of BASIC 

Note that you can't read ona RAM bank and wrfte to the other; if 
you select either HAM bank for reading, you get that one for writing 
as welL 

You can t read from ROM in part of the bank-switched memory and 
read from HAM in the rest: specifically, you can't read the Monitor in 
ROM while reading bank-switched RAM. II you want to use the 
Monitor firmware with a program in bank-switchied RAM, first copy 
tfie Monitor from ROM (locations *Feoo through *FFCS] into lower 
RAM and then into bank-switched HAM. 

To s^e Hqw to use these switches, iook at the following section 
of an assembly-language program: 



flD 


B3 


CO 


LDfi 


*C0B3 


SELECT END 4K BANK 












READ/WRITE 




83 


CO 


LDfl 


*C083 


i BY TWO CDNSECUTWE READS 


fl9 


DO 




LDA 


'(DO 


J SET UP. . .. 


95 


01 




STA 


BEGIN 


J ...NEW,.. 


ftS 


FF 




LDA 


ttfV 


i . . .MftlH-MEMORV, . . 


BE 


02 




STA 


END 


; . . .PaiNTERS. . . 


20 


97 


C9 


JSR 


RAMTST 


; . . .FDR 12K BANK 


AD 


SB 


CO 


LDA 


«C08B 


; SELECT 1ST BANK 


£0 


97 


09 


JSR 


RflMTST 


; USE ABOVE POINTERS 


flD 


83 


CO 


LDfl 
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! SELECT 1ST BANK t 












WRITE PROTECT 
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ft9 
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IMC 


TSTHUM 
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1 D 




INC 


TSTKUM 


A9 


oa 




LD(\ 


'PftT4K 


20 


58 


C9 


JSR 


WPTSINIT 



SELECT END BANK 4 
WRITE PROTECT 



SELECT 1ST BANK A 
READ/WRITE 

BY TWO CONSECUTIVE READS 
FLAG RAM IN REfiD/WRITE 



The LDA instruction, which performs a read operation to the 
specified memory location, is used for setting the soft switches. 
The unusual sequence of two consecutive LDA instructions 
performs tt^e two consecutive reads that write-enable this area of 
RAM; in this case, the data that are read are not used. 



Auxitiary Memory and Firmware 

By Installing an optional card in the auxiliary slot, you can add 
more memory to the Apple lie. One such card is \he eo-column 
text card, whtcfi has IK bytes of additional RAI^ for expanding 
the text display from 40 columns to 80 columns. 



Another optional card, the extended BO-column text card, has 
64K of additional RAfW. A IK-byte area of this memory serves 
the same purpose as the memory on the SO-column text card: 
expanding the text display to 80 columns. The other 63K bytes 
can be used as auxiliary program and data storage. If you use 
only 40'Column displays, the entire 64K bytes is available for 
programs and data. 



Warning 

Do not attempt to use the auxiliary memory from a BASIC program. 
Th9 BASIC interpreter uses several areas in main RAM. including 
the stack and the zero page. If you switch to auxiliary memory in 
these areas, the BASIC interpreter fails and you must reset the 
system and start over. 
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Figure 4-4 Memorv map wilh Auxiliary 
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As you can see by studying the memory map in Figure 4-4, the 
auxiliary mennory is broken into two large sections and one small 
one. The largest section is switched into the memory address 
space from 5 1 2 to -191 5 1 (* 2 o o through « BFF F ). This space includes 
the display buffer pages: as described in Chapter 2, space in 
auxiliary memory is used for one half of the 80-column text 
display. You can switch to the auxiliary memory for this entire 
memory space, or you can switch just the display pages: see the 
section "Memory Mode Switching"", below, 

If the only reason you are using auxiliary memory is for the BD- 
coiumn display, note that you can store into the display page in 
auxiliary memory by using the eosTOftE and pp\GEZ soft switches 
described in the section "Display Mode Switching' in Chapter 2. 
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The other large section of auxiliary memory fs switched into the 
memory address space from S2K to 6<1K (JDQOO through »ffff). 
This memory space and the switches that control it are described 
above in the section "Sank-s witched Memory \ If you use the 
auxiliary RAM in this space, the soft switches have (he same 
eflect on the auxiliary RAM that they do on the main RAM: the 
bank switching is independent of the auxiliary-RAM switching. 

Mote that the soft switches for the bank-switched memory, described 
jn the previous section, do not change when you swFtch to auxiliary 
RAM. In particular, If ROM is enabted in the bank-swilched memory 
space before you switcli lo auxiliary memory, the ROM will still be 
enabled after you switch. Any time you switch the bank-switched 
section of auxiliary memory in and OLrt, you must also make sure 
that the bank switches are set properly. 

When you switch in the auxiliary RAM in the bank-switched 
space, you also switch the first two pages, from Q to 5i i (»OOQ0 
through toi FF), This part of memory contains page zero, which is 
used for important data and base addresses, and page one. 
which is the 6502 stack. The stack and zero page are switched 
this way so that system software running in the bank-switched 
memory space can maintain its own stack and zero page while it 
manipulates the 48K address space (from *0200 to *BFFF) in either 
main memory or auxiliary memory. 



Memory Mode Switching 

Switching the 48K section of memory is performed by two soft 
switches: the switch named RAMRD selects main or auxiliary 
memory for reading, and the one named RflMWRT selects main or 
auxiliary memory for writing. As shown in Table 4-6, each switch 
has a pair of memory locations dedicated to it, one to select 
main memory, and the other to select auxiliary memory. Enabling 
the read and write functions independently makes it possible for 
a program whose instructions are being fetched from one 
memory space to store data into the other memory space. 



Warning 

Do not use these switches without careful planning. Careless 
switching between main and auxiliary memories is almosl certain to 
have catastrophic effects on the operation of the Apple lie. For 
example, it you switch to auxiliary memory with no auxiliary memory 
card installed, the program thai is running will stop and you will 
have to reset the AppEe lie and start over. 
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Writing to the soft-switch a.\ location tco03 turns ramrd on and 
enables auxiliary memory for reading; writing to location *C00 2 
turns RAMRD off and enables main memory for reading. Writing to 
tine soft-switch at location *C005 turns RAMWRT on and enables the 
auxiliary memory tor writing; writing to location *C004 turns RAWWRT 
off and enables main memory for writing. By setting these 
switches independently, you can use any of the four 
combinations of reading and writing in main or auxiliary memory. 

Auxiliary memory corresponding to text Page 1 and higti- 
resolution graptiics Page l can be used as part of the address 
space from »DPao to *bfff by using RAriRD and RflMWRT as described 
above. These areas in auxiliary RAM can also be controlled 
separately by using the switches described in the section 
"Display Mode Switching" in Chapter 2. Those switches are 
named sosTORE. PA&E2, and hires. 

As shown in Table 4-6, ttie 80 STORE switch functions as an 
enabling switch: with it on, the PflGE2 switch selects main memory 
or auxiliary memory. With the hires switch off, the memory space 
switched by PAGE2 is the text display Page 1. from *040 to *o7FF; 
with H [RES on, PAGE2 switches both text Page 1 and high -resolution 
graphics Page 1, from »£0 0O to «3FFF. 

If you are using both the auxiliary-RAM control switches and the 
auxiliary-display-page control switches, the display-page control 
switches take pnoriJy: if aoSTDR^ Is off, RAMRD and RAMUiRT work for 
the entire memory space from *0£0D to *BFFF, but if 
eosTDRE is on. RAnRD and RAMWRT hav© no effect on the display 
page. Specifically, ifeoSTORE is on andHiRES is off, pa0E2 controls 
text Page 1 regardless of the settings of RAfiRD and RAfnuiRT. 
Likewise, if 80 store and HIRES are both on, PflGE2 controls both text 
Page 1 and high-resolutton graphics Page 1 , again regardless of 
RAMRD and RAnWRT. 

A single soft switch named ALTZP (for alternate zero page) 
switches the bank-switched memory and the associated stack 
and ^ero page area between main and auxiliary memory. As 
shown in Table 4-6. writing to location *C0 03 turns ALT2P on and 
selects auxiliary-memory stack and zero page: writing to the soft 
switch at location *G008 turns ALTZP off and selects main-memory 
stack and zero page for both reading and writing. The section 
'Auxiliary-memory Routines", below, describes firmware that you 
can call to help you switch between main and auxiliary memory- 
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When Ihese switches are on. auxilrary 
memory is being used; when Ihey are 
off, main memory is being used- 



Table 4-6 Auxiliary-memary Select 
Switches 

[1} When eOSTDHEis en, the Pf\Q^2 
switch selects mam or auxiliary display 
memory. 

(2) When eOSTQRElB on, the HIHES 
switch enables you to jse the PftGtE 
switch to switch between the 
high-resoljtron Page-1 area in main 
memory or auxiiiaiy memory- 



There are three more locations associated with the auxiliary- 
memory switches. The high-order bits of the bytes you read at 
these locations tell you the settings of the three soft switches 
descnbed above. The byte you read at location *coi 3 has Its high 
bit set to 1 if ramrd is on (auxiliary memory is read-enabled}, or 
if RAMRD (s off (the 48K block of main memory is read-enabled). 
The byte location «CQ1 ^ has its high bit set to 1 if RAnwRT is on 
(auxiliary memory is write-enabled), or if RflPIWRT is off (the 48K 
block of main memory is write-enabled). The byte at location 
»coiG has tts high bit set to 1 if f^LTZP is on (the bank-switched 
area, stack, and zero page in the auxiliary memory are selected), 
or if ftLTZP is off (these areas in main memory are selected). 



Name 



Function 



Hex 



Location 

□ecimal 



RAMRD Read auxiliary memory 
Read .main memory 
Read Rf^PlRDswitCh 



RAMuRT Write auxiliary memory 
Write mam memory 
Read RAMWRT switch 



»CO05 
*C004 



8Q5T0RE On: access display page tC001 
Off: use RAMRD, RAMWRT ICOOO 
Read 80 STDftE: switch *COie 



PAGE2 



Page 2 on (Ajk- memory) 
Page 2 oifl (Main memory) 
Read PftGESswilch 



• C055 49237 
*C054 4923G 
tCOlC 43180 



Hi RES On- access hi-res pages 
Otf; use RftMRD, RAMWRT 

Read HI RES switch 



*C057 
tC056 



492 39 
49238 
49181 



ALTZP 
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*C003 ^9lS5 -16381 Wrte 
tCDOS ^91S4 -16382 Write 
*CD13 49171 1G3G5 Read 



491 57 - 18379 Write 
49156 -16380 Wrile 
49172 -163S4 Read 



491 S3 - 16383 Write 
491 S2 16384 Write 

491 76 - iG3eo R&ad 



16299 1 

16300 1 
-1B3S6 Read 



1 6^97 2 
16298 2 

I63S5 Read 



Auxiliary stack fi, z. p. *C009 49161 16373 Write 

Main stack a zero page ICOOS 49160 - 16374 Write 

Read ALTZP switch ICOIG 49174 -16352 Read 



Table 4-7 Auxiliary-memory Roulines 



In order to have enouQh memoTy locations for all of the soft 
switches and remain compatible with the Apple II and Apple li Plus, 
the soft switches listed rn Tabte 4-6 share their memory locations 
with the Keyboard functions listed in Table 2-2- The operations — 
read or write — shown in Table 4-6 for controlling the auxiliary 
memory are just the ones that are not used for reading the 
keyboard and clearing the strobe. 



Auxitiary-memory Subroutines 

M you want to write assembly-language programs that use 
auxiliary memory but you don't want to manage the auxiliary 
memory yourself, you can use the built-in auxiliary-memory 
subroutines These subroutines make it possible to use the 
auxiliary memory without having to manipulate the soft switches 
described in the previous section. 

The subroutines described below make it easier to use auxiliary 
memory, but they do not protect you from errors. You still have to 
pian your use of auxiliary memory to avoid catastrophic effects on 
your program. 

You use these built-in subroutines the same way you use the I/O 
subroutines described in Chapter 3; by making subroutine calls to 
their starting locations. Those locations are shown in Table 4-7. 



Subroutirre 


Location 


□escriplion 


Name 






ftUXnOVE 


•C31 1 


Moves data bkicks betwe&n main and auxiliary memory 


XFER 


*C314 


Tfansters program corilrol between main and auxiliary 






memciry 



i 




76 



Memory Organization 



Table 4-e Parameters for AUXMQVE 

Routine 



Moving Data to AuMitiary Memory 

Jn your assembly-fanguage programs, you can use the built-in 
subroutine named AUXMDVE to copy blocks of data from main 
memory to auxiliary memory or from auxiliary memory to main 
memory. Before calling this routine, you must put the data 
addresses into byte pairs in page zero and set the carry bit to 
select the direction of the move — main to auxiliary or auxiliary 
to main. 

Warning 

Don't try to use ftuxMDVE to copy data in page zero or page one (the 
6502 stack) or in the bank-switched memory (iDOQO-tFFFF). auxmdve 
uses page zero all during the copy, so it can't handle moves in the 
ruemory space switched by Altzp. 

The pairs of bytes you use for passing addresses to this 
subroutine are called Ai , A2, and A^, and they are used for 
parameter passing by several of the Apple lie's built-in routines. 
The addresses of these byte pairs are shown in Table 4-8. 



Name 


Locatkon 


Parameter pasfied 


Carry 




1 = Move from main lo auxiliafy meiriory 
= Move from auxiliary to main rriemory 


AIL 
A1H 


*3C 
«3I> 


Source starting address, low-order byle 
Source starting address, high-order byte 


A2L 
A2H 


• 3E 
I3F 


Source ending ackjress, iow-order byte 
Source endiirg address, high-ofder byte 


A41. 
A4H 


f42 
f43 


Destinalion starting address, low-order byte 
Destination starting address, high-order byte 
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Table 4-9 Paramelensfor XFER 
Routine 



Put the addresses of the first and iast bytes of the block of 
memory you want to copy into A1 and A2. Put the starting 
address of the block of memory you want to copy the data to 
Into A4. 

The AUKMoyE routine uses the carry bit to select the direction to 
copy the data. To copy data from main mernory to auxiliary 
memory, set the carry bit; to copy data from auxiliary memory to 
main memory, clear the carry bit. 

When you make the subroutine call to aukmdve. the subroutine 
copies the block of data as specified by the A registers and the 
carry bit When it is finished, the accumulator and the X and Y 
registers are just as they were when you called it. 

Transferring Control to AuxiliarY Memory 

You can use the built-in routine named XFER to transfer control to 
and from program segments in auxiliary memory. You must set 
up three parameters before using xfeR: the address of the routine 
you are Jransfernng to^ the direction of the transfer <main to 
auxiliary or auxiliary to main), and which page zero and stack 
you want to use. 



Name 
Location 



Parameter passed 



Carry 



Overflow 



»3ED 
*3EE 



1 = Transfer from main to auxiliary memory 

- Transfe? rrom auxiliary lo main memory 

1 = Use pago aero and stack in auxiliary memory 
= Lise page zero and stack in main memoiiv 

Program starting address, low-order byte 
Program starting actdress, high-order byte 



Put the transfer address into the two bytes at locations »3ED and 
«3EE . with the low-order byte first, as usual. The direction of the 
transfer Is controlled by the cany bit: set the carry bit to transfer 
to a program in auxiliary memory; clear the carry bit to transfer to 
a program in main memory. Use the overflow bit to select which 
page zero and stack you want to use; clear the overflow bit to 
use the main memory; set the overflow bit to use the auxiliary 
memory. 



a 

J 



-J 
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After you have set up the parameters, pass control to the xfer 
routine by a jump instruction, rather than a subroutine calL XFER 
saves the accumulator and the transfer address on the current 
stack, then sets up the soft switches for tlie parameters you have 
selected and jumps to the new program. 



Warning 

II Is ihe programrrier's responsibility to save the current stack pointer 
somewhere in Ihe current mGmory space before using xfer and to 
restore it after regainfng controi Failure to do so will cause program 
errors. 



The Reset Routine 

To put the Apple lie into a known state when it has just been 
turned on or after a program has malfunctioned, there is a 
procedure called the reset routine. The reset routine is buiit into 
the Apple lie's firmware, and it is fnitiated any time you turn 
power on or press the [ RESET J key while hoiding down the 
I CONTROL ] key. The reset routine puts the Apple Me into its normal 
operating mode and restarts the resident program. 

When you initiate a reset, hardware in the Apple lie sets the 
memory-controlling soft switches to normal: main board RAM and 
ROM are enabled, and, if there is an 80-coiumn text or extended 
80-column text card in the auxiliary slot, expansion slot 3 is 
allocated to the built-in 80-column firmware. Auxiliary RAI^ is 
disabled and the bank-switched memory space is set up to read 
from ROM and whte to RAfvl, using the second bank at *D0 0O. 

The reset routine sets the disp Say-controlling soft switches to 
display 40-coiumn texl Page 1 using the primary character set 
then sets the window equal to the full 40-column display, puts 
the cursor at the bottom of the screen and sets the display 
format to normal. 

The reset routine sets the keyboard and display as the standard 
input and output devices by foadmg the standard I/O links (see 
Chapter 6), It turns annunciators and 1 off and annunciators 2 
and 3 on, clears the keyboard strobe, turns off any active 
accessory-card ROM (see Chapter 6) and outputs a bell (tone). 

The Apple lie has three types of reset: power-on reset, also 
called cold-start reset; warm-start reset; and forced cold-start 
reset. The procedure described above is the same for any type 
of reset. What happens next depends on the reset vector. The 
reset routine checks the reset vector to determine whether it is 
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valid or not, as described below in the section, The Reset 
Vector' . If the reset was caused by turning the power on, the 
vector wiil not be valid, and the reset routine will perform the 
cold-start procedure. It the vector is valid, the routine will perform 
the warm-start procedure. 

The Cofd-stan Procedure 

If the reset vector is not valid, either the Apple lie has just been 
turned on or something has caused memory contents to be 
changed. The reset routine ciears the display and puts the string 
"Apple |[" at the top of the display. It ioads the reset vector and 
the validity-check byte as described below, then starts checking 
the expansion slots to see if there is a disk drive controller card 
in one of them, starting with slot 7 and working down. If it finds a 
controller card, it initiates the bootstrap (startup) routine that 
resides in the controller card^s firmware. The bootstrap then loads 
the Disk Operating System from the disk in drive 1 . When DOS 
has been loaded, It displays other messages on the screen. If 
there is no disk in the disk drjye, th e driv e mo tor just keeps 
spinning until you press rcDMT RDL | - \ RESET | . For more information 
about DOS and the startup procedure, see the DOS Manuai. 

If the reset routine doesn't find a controller card, or if you press 
I CONTROLl -j RESET [again before the startup procedure has been 
completed, the reset routine will continue without using the disk, 
and pass control to the buiSt-in Applesoft interpreter. 



A program in bank-switched RAM cannot use the reset vector to 
regain control after a reset, because the reset routine enables ROM 
in the bank-switched memory space. If you are using Integer 
BASIC, which is in the bank-switched RAM, you are also using 
DOS, and it Is DOS that controls the reset vector and restarts 
BASIC. 
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The Warm-start Procedure 

Whenever you press f CONTROL ] - j~ftESET Jwhen the Apple lie has 
already completed a cold-start reset, the reset vector is still valid 
and it is not necessary to reinitialize the entire system. The reset 
routine simply uses the vector to transfer contnji to the resident 
program, which is normally the built-in Applesoft interpreter. It the 
resident program is indeed Applesoft, your Applesoft program 
and variables are still intact. If you are using DOS, it is the 
resident program and it restarts either Applesoft or Integer^ 
BASIC, whichever you were using when you pressed [cdntrdT]- 
PRESET j. 



-J 



forced Cold Start 



If a program has loaded the reset vector to point to the beginning 
of the program, as described below, pressing [ caNTRDL~| -|_ RES ET ] 
causes a warrn-slart reset that uses the vector to transfer control 
to that program. If you want to stop such a program without 
turning the power off a nd on, you can force a cold-start reset by 
holding down the I COm trq lJ key and the I OPEN-APPLE ] key, then 
pressing and releasing the reset j key. 

When yuy want to stop a program uncorrditlonally — for example, to 
start up (he Apple Me with some othe r program — you should use 
the forced cold'Starl reset, [ cqhTrdl | - |OPEN-APPLE] -|_R£SET].inslead oi 
turriing the power off and on. 

Wh eneve r you press | CONTROL | - ! RE SE'Tl fir mware i n th e A pp le I le 
always checks to see whether either ! apple | key is down. If the 
fTOL ID- APPL E J key Is down , with or withQutthe [ DPEM-flPPLE | key, 
the firmware p erforms the setf-test described below. If onEy the 
j OPEN -APPLE ] key is down, (he firmware starts a forced cold-start 
reset. First, it destroys the program or data in memory by writing 
two bytes of arbitrary data into each page of main RAfyi. The two 
bytes that get written o\/er in page 3 are the ones that contain 
the reset vector. The reset routine then performs a normal cold- 
start reset. 



The Reset Vector 

When you reset the Apple lie, the reset routine transfers control 
to the resident program by means of an address stored in 
page 3 of main RAfvl. This address is called a vector because It 
directs program control to a specified destination. There are 
several other vector addresses stored in page 3, as shown in 
Table 4-10. including the interrupt vectors described in Chapter 6, 
and the DOS vectors described in the DOS Manual. 

The cold-start reset routine stores the starting address of the 
built-in Applesoft interpreter, low order byte frrst. in the reset 
vector address at locations i o i o and i C 1 1 (hexadecimal * 3F2 and 
*3F3). It then stores a validity check byte, also called the power- 
up byte, at location i Oi £ (hexadecimal *3F4). The validity-check 
byte is computed by performing an excluawe-DR of the second 
byte of the vector with the constant 165 (hexadecimal SA5). Each 
time you reset the Apple Me, the reset routine uses this byte to 
determine whether the reset vector is still valid. 
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Table 4-10 Page 3 Vectors 



You can change the reset vector so that the reset routine will 
transfer control to your program instead of to the Applesoft 
interpreter For this to work, you must also change the validity- 
check byte to the eicc lua i ve-OR of the high-order byte of your new 
reset vector with the constant 165 ($A5). If you fail to do this, 
then the next time you reset the Apple lie, the reset routine will 
determine that the reset vector is invalid and perform a cold-start 
reset, eventually transferring control to the disk bootstrap routine 
or to Applesoft. 



Vector addreas 
Decimal Hex 


Vector function 


1 G08 
1 QD9 


t3F0 
*3F1 


Address oi the subrouOne that hardies BRK requesls 
{normally *59. *Ffl). 


1010 
1 01 1 


t3F2 
t3F3 


Reset veclor (see texl). 


1012 


S3F4 


Power-up byie (see text). 


1 013 
1 01 4 

1 01 5 


*3F5 
*3FG 
*3F7 


Jump Instruclipn la the subrouHne thai handles Applesoft 
commariOs (normally *4C, *SS. *FFl. 


1 01G 
1 01 7 
^OlQ 


t3re 

*3Ffl 


Jump instruction to the subroutine that handles user 
(1 CnNTRDL ]-V) commands. 


1.019 

1 oao 

1 021 


t3FB 
t3FC 
*3FD 


Jump instruction 1o the subfoutine lhat handles 
non-maskable interrupts. 


1 QSS 
1 


f3FE 
• 3FF 


Interrupt vector (address of the subrojline that handles 
interrupt requests}. 
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The reset routine has a subroutine that generates the validity- 
check byte for the current reset vector. You can use this 
subroutine by doing a subroutine call to location -i 169 
(hexadecimal *fb6F). When your program finishes, it can return 
the Apple Me to normal operation by restoring the original reset 
vector and again calling the subroutine to ftx up the validity-check 
byte. 



Automatic Self-test 

Ef yo u reset the A pple lie by holding down the [ control 1 key and 
the |_SOLi^- APPLeJ key while pressing and releasing the RESE T ] 
key, the reset routine will start running the built-in self-test. 
Successfully running this test assures you that the Apple lie is 
operational. 



Warning 

The self-tesi routine tests the Apple lie's prog rarmm able memory by 
writing and then reading it. All programs and data in programmable 
memory when you run the self-test are destroyed. 



The selMest takes several seconds to run. While ft ss running, 
the display changes from black to white and bach twice. If the 
test finishes normally, the Apple He displays an "OK" message 
and waits for you to request a normal reset. 

It the self-test detects something wrong, it displays an error 
message and stops. If you have been running programs prior to 
running the self-test, some soft-switches could be on, causing the 
self-test to fail and display an error message. If this happens, 
turn the power off for several seconds^ then turn it back on and 
run the self-test again If it still fails, there is really something 
wrong; to get it corrected, contact your Apple dealer for service. 
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Chapter S 



Using The Monitor 



The System Monitor is a set of subroutines in the Apple lie 
firmware. The Monitor provides a standard interface to the built-in 
)/0 devices described in Cfiapter 2. The I/O subroutines 
described in Chapter 3 are part of the System Monitor. 

The Disk Operating System and the BASIC interpreters use 
these subroutines by direct calls to their starting locations, as 
described for the I/O subroutines in Chapter 3; the starting 
addresses for all of the standard sttbrouttnes are listed in 
Appendix C, If you wish, you can call the standard subroutines 
f rom your prograrns in the same fashion. 

You can perform most of the Monitor functions directly from the 
keyboard. This chapter telis you how to use the Monitor to 

• look at one or more memory locations 

• change the contents of any location 

• write programs in machine language to be executed directly 
by the Apple lie's microprocessor 

• save blocks of data and programs onto cassette tape and 
read them back in again 

• move and compare blocks of memory 

• invoke other programs from the Monitor 

Invoking the Monitor 

The System Monitor starts at memory location *ff69 {decimal 
5538B or -151). To invoke the Monitor, you make a CALL statement 
to this location from the keyboard or from a BASIC program. 
When the Monitor is running, its prompting character, an asterisk 
(• ), appears on the left side of the display screen, followed by a 
blinking cursor. 
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To use the Monitor, you type commands at the keyboard. When 
you have finished using the Monitor, you return t o the BASIC 
language you were previously u sing by pressing [ CDNTRDl1 ~ 
I RESEf I , by typing [ CONTROL | -C and pressing [R ETURN or 
by typing 3D0G, which executes the resident program — usually 
Applesoft — whose address is stored fn a jump instruction at 
location t3D0. 

Syntax of Monitor Commands 

To give a command to t he Mon itor, you type a line on the 
keyboard, Ihen press | igETURN | . The Monitor accepts the line using 
the standard I/O subroutine GETLN described in Chapters, A 
Monitor command can be up to 255 characters in length, ending 
with a carriage return. 

A Monitor command can include three kinds of information: 
addresses, data values^ and command characters. You type 
addresses and data values in hexadecimal notation. Hexadecimal 
notation uses the ten decimal digits (0-9) and the first six letters 
(A-F) to represents the sixteen values from to 15. A pair of 
hexadecimal digits represents values from to 255, corresponding 
to a byte, and a group of four hexadecimal digits can represent 
values from lo 65.536, corresponding to a word. Any address 
in the Apple lie can be represented by four hexadecimal digits. 

When the command you type calls for an address, the Monitor 
accepts any group of hexadecimal digits. If there are fewer than 
four digits in the group, it adds leading zeros; if there are more 
than Jour hexadecimal digits, the Monitor uses only the last four 
digits. It follows a similar procedure when the command syntax 
calls for two digit data values. 

Each command you type consists of one command character, 
usually the first letter of the command name. The Monitor 
recognizes 22 different command characters. Some of them are 
punctuation marks, some are uppercase letters, and some are 
control characters. Note: although the Monitor recognizes and 
interprets them, control characters typed on an input line do not 
appear on the screen. (See the Summary of Monitor 
Commands' at the end of the chapter.) 

This chapter contains many examples of the use of Monitor 
commands. In the examples, the commands and values you type 
are shown in a normal typeface and the responses of the Monitor 
are in a computer typeface. Of course, when you perform the 



J 
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examples, all of the characters that appear on the display screen 
will be in the same typeface. Some of the data values displayed 
by your Apple Me may differ from (he values printed in these 
examples, because they are variables stored in programmable 
memory. 

Monitor Memory Commartds 

When you use the Monitor to examine and change the contents 
of memory, it keeps track of the address of the last location 
whose value you inquired about and the address of the location 
that is next to have its value changed. These are called the last 
opened tocation and the next changeable location. 



Exam'mmg Memory Contents 

When you type the address of a memory location and press 
I RETURN \ the Monitor responds with the address you typed, a 
dash, a space, and the value stored at that locatton, like this: 

•EOOO 
EOOO- 20 
•33 

0D33-AA 



Each time the Monitor displays the value stored at a location, it 
saves the address of that localion as the last opened location 
and as the next ctiangeable focation. 



Memory Dump 

When you type a period (.) followed by an address, and then 
press I RETURN , the Monitor dhsplays a memory dump: the data 
values stored at all the memory locations from the one following 
the fast opened locatfon to the location whose address you typed 
following the period. The Monitor saves the Jast iocation 
dispJayed as both the last opened location and the ne;ct 
changeable location. In these examples, the amount of data 
displayed by the Monitor depends on how much larger than the 
last opened location the address after the period is. 
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• 20 

0020- OD 



3 

.26 lU^ 

J 



A memory dump includes several different items of information. 
The first line in the dump begins with the address of the location 

following the last opened location; all other lines begin with 

addresses that end alternately in zeros and eigtits, and there are 
never more than eight data values displayed on a single line in a 
memory dump. ^ 

When the Monitor performs a memory dump, it starts at the 

location immediately following the last opened location and ^ 

displays that address and the data value stored there. It then 

displays the values of successive locations up to and including 

the location whose address you typed, but only up to eight ^ 

values on a line. When it reaches a location whose address is a 

multiple of eight— that is, one that ends with an B or a — it 

displays that address as the beginning of a new line, then _ _i 

continues displaying more values. 
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0028- 
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00 
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99 
















•.315 


0301 - 
0308- 
031 0- 


B9 

09 


DO 
09 
85 


08 
C8 
^7 


Qfl 
DO 
AD 


DA 
F4 

CC 


OA 
A6 

03 


93 
2B 


A9 


•.32A 


031G- 
Q3te- 
0320- 
0328- 


as 

84 
CO 
43 


41 
40 
35 
03 


8A 
3F 
20 


4A 
A9 


4A 
SD 


4A 
85 


4A 
3E 


09 
2D 
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After the Monitor has displayed the value at Ihe location whose 
address you specified in the command, it stops the memory 
dump and sets that location as both the last opened location and 
the next changeable location. If the address specified on the 
input line is less than the address of the last opened location, the 
Monitor displays only the address and value of the location 
following the last opened location. 

You can combine the two commands, opening a location and 
dumping memory, by simply concatenating them: type the first 
address, a period, and the second address. This combination of 
two addresses separated by a period is called a memory range. 



•300.32F 
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C2 
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1B 
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DO 


03 


3C 
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40 


00 



0040- 3D 
•E015.E025 
£01S- 4C ED FD 

E018- A9 20 C5 24 BO OC A9 SD 
EOaO- AO 07 20 ED FD A9 



Pressing the [ return J key by itself causes the Monitor to display 
one line of a memory dump: that is, a memory dump from the 
location following (he last opened location to the next muitiple-of- 
eight boundary. The Monitor saves the address of the last 
location displayed as the last opened location and the next 
changeable location. 
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#5 

O0O5- 00 
' ["RETURHJ 
OG 00 
* ("ret URN J 

OOOe- 00 DO 00 00 OO OO 00 00 
#32 

0032- FF 

« [returnJ 

AA 00 C2 05 02 
* \ RETUffNj 

038- 1B FD DO 03 3C 00 3F 00 



Changing Memory Contents 

The previous section showed you how to display the values 
stored in the Apple lie's memory; this section shows you how to 
change those values. You can change any location in 
RAM (programmable memory) and you can also change the soft 
switches and output devices by changing the locations assigned 
to them. 



Warning 

Use these commands carefully. If you change the zero-page 
locations used by Applesoft and DOS, you may lose programs or 
data stored in memory- 
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Changing One Byte 

The previous commands keep track of the nex^t changeable 
location; these comrnands make use of it. In the next example, 
you open focalion 0, then type a colon followed by a value. 

•0 

0000- 00 
•:5F 

The contents of the next changeable location have just been 
changed to the value you typed, as you can see by examining 
that location: 

•0 

0000- 5F 



You can also combine opening and changing into one operation 
by typing an address followed by a colon and a value. In the 
example, you type the address again to verify the change, 

•302:42 
•302 

0302- 42 



When you change the contents of a location, the value that was 
contained in that location disappears, never to be seen again. 
The new value will remain until you replace it with another vaJue. 

Changing CQfisecutive Locations 

You don't have to type a separate command with an address, 
a colon, a value, and | return | for each location you want to 
change. You can change the the values of up to eighty-five 
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consecutive locations at a time (or even more, if you omit leading 
zeros from the values) by typing only the initial address and 
colon followed by all th& values separated by spaces, and ending 
with I RETU RrTl . The Monitor wilt duly store the consecutive values 
in consecutive locations, starting at the location whose address 
you typed. After it has processed the string of \^alues, it takes the 
location following the last changed location as the next change- 
able location. Thus, you can continue changing consecutive 
locations without Typing an address on the next input line by 
typing another colon and more values. In these examples, you 
first change some locations, then examine them to verify the 
changes, 



* 300:69 01 20 ED FD 4C 3 
•300 

0300- 69 



*l RETURN 



01 2a ED FD 4C QO 03 
•10:0 1 2 3 
•:4 5 6 7 
#10.17 

DQtO- 00 01 02 03 04 05 06 07 



3 

'J 

J 

'J 
'J 



Moving Data in Memory 

You can copy a bbck of data stored in a range of memory 
locations from one area in memory to another by using the 
Monitor's MOVE command. To move a range of memory, you must 
tell the ^4onitor both where the data is now situated in memory 
— the source locations — and where you want the copy to go — 
the destination locations. You give this information to the Monitor 
by means of three addresses: the address of the first location in 
the destination and the addresses of the first and last locations in 
the source. You specify the starting and ending addresses of the 
source range by separating them with a period. You separate the 
destination address from the range addresses with a less-than 
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character (<), which you may think of as an arrow pointing in the 
direction ol the move. Finally, you tell the Monitor that this is a 
MOVE command by typing the letter ti. The format of the complete 
MOVE command looks like this; 

{destinaliony < {start} . {end} M 

When you type the actual command, the words in curly braces 
should be replaced by hexadecimal addresses, and the braces 
and spaces should be omitted. Here are some examples of 
memory moves. First, you examine the values stored in one 
range of memory^ then store several vafues in another range of 
memory; the actual flOVE commands end with the letter M: 

• O.F 

0000- sr 00 OS o? oo oo oo oo 

OOOS- 00 00 00 00 00 00 00 00 

*300:A9 BD 20 ED FD A9 45 20 DA FD 4C 00 03 



•300.30C 
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The Monitor moves a copy of the data stored in the source range 
of locations to the destmation locations. The values in the source 
range are left undisturbed. The Monitor remembers the last 
location in the source range as the last opened iocation, and the 
first location in the source range as the next changeable location. 
If the second address in the source range specification is less 
than the first, then only one value {that of the first location in the 
range) will be moved. 

If the destination address of Wie MOVE command is inside the 
source range of addresses, then strange (and sometimes 
wonderful) things happen: the locations between the beginning of 
the source range and the destination address are treated as a 
sub-range and the values in this sub-range are repiicated 
throughout the source range. See the section ' Special Tricks with 
the Monitor" for an interesting application of this feature. 



J 

I 

J 

!j 

a 



Companng Data in Memory 

You can use the verifv command to compare two ranges of 
memory using the same format you use to move a range of 
memory from one place to another. In fact, the VER I FV command 
can be used immediately after a move to make sure that the move 
was successful. The verify command, like the MOVE command, 
needs a range and a destination. The syntax of the VER l rv 
command is: 

{destination} < {start} . {end} v 

The Monitor compares the values in the source locations with the 
values in the locations beginning at the destination address. If 
any values don't match, the Monitor displays the address at 
which the discrepancy was found and the two values that differ. 
In the example, you store data values in the range of locations 
from to *D. copy them to locations starting at *300 with the move 
command, and then compare them using the ver I FY command. 
When you use the vesifv command after you change the value 
at location G to »E4, it detects the change. 



'J 
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'A 
'A 



-0:D7 F2 E9 F4 F4 E5 EE AO E2 F9 AO C3 C4 C5 



•30O<0.DM 
*300<O.DV 
• 6:E4 

•300<O.DV 

0006-E4 izty 



\i the VER IFV command finds a discrepancy, it displays the 
address of (he locafion in the source range whose value differs 
from its counterpart in the destination range. If there is no 
discrepancy, VERIFV displays nothing. The VERIFY command 
leaves tfie values in both ranges unchanged. The last opened 
location is the last location in the source range, and the next 
changeable location is the first location in the source range, just 
as in the MDVE command. If the ending address of the range is 
less than the starting address, the values of only the first 
locations h the ranges will be compared. Like the nOVE command, 
the VER I FY command atso does unusual things If the destination 
address Is within the source range; see the section "Special 
Tricks with the Monitor' . 

Monitor Register Command 

Even though the actual contents of the 6502 s internal registers 
are changing as you use the Monitor, you can examine the 
values that the registers contained at the lime the Monitor gained 
contfo], either because you called it or because the program you 
are debugging stopped at a break (BRK). You can also store 
new register values that will be used when you execute a 
program from the Monitor using the GP command, described 
below. 



Examining and Changing Registers 

When you call the Monitor, it stores the contents of the B502 
registers in memory. The registers are stored in the order A, X, 
Y, P (processor status register), and S stack pointer), starting at 
location *'t5 (decimal 69). When you give the Monitor a GO 
command, the Monitor loads the registers from these five 
locations before it executes the first instruction in your program. 
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Typing fcO NTRaL | -£ and pressing LRETURN] invokes the Monitor's ^ I 

EXAMINE command, which displays the stored register values and J 

sets the location containing the contents of the A-register as the ^ ^ 

next cliangeable location. After using the Examine command, you I 

can change the values in these locations by typing a coion and J 

then typing the new values separated by spaces. In the foltowing ^ 

example, you display the registers, change the first two. and then ^ I 
display them again to verify the change. 

> [ cdktrdl1 -E J 

A-OA X=FF Y-D8 P=^BO S-FB 



•:B0 02 
A=EO X-02 Y=DS P-BO S«FB 



Monitor Cassette Tape Commands 

The Apple lie has two jacks for connecting an audio cassette 
tape recorder, With a recorder connected, you can use the 
Monitor commands described below to save the contents of a 
range of memory onto a standard cassette and recall it again for 
iater use. 



Saving Data on Tape 

The Monitor's wr [TE command saves the contents of up to 65,536 
memory locations on cassette tape. To save a range of memory 
on tape, give the Monitor the starting and ending addresses of 
the range, followed by the letter w (for write), like this: 

{start} . {end} w 

Don't press [RETURk] yet: first, put the tape record er in re cord 
mode and let the tape run for a second, then press L^E_UJRH_1 ■ The 
Monitor will write a ten-second tone onto the tape and then write 
the data The tone acts as a leader: later, when the Monitor 
reads the tape, the leader enables the Monitor to get in step with 
the signal from the tape. When the Monitor is finished writing the 
range you specified, it wil' sound a bell (beep) and display a 
prompt. You should rewind the tape and label it with the memory 
range that's on the tape and what it's supposed to be. 
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Here s a small example you can save and use later to try out the 
READ command. Remember that you must start the cassette 
recorder in record mode before you press | return] after typing 
ttie UIRITE command. 



tO.FF FF AD 
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•0.14 
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*0.14W 



It takes about 35 seconds total to save the values of 4,096 
memory locations preceded by the ten-second leader onto tape. 
This works out to an average data transfer rate of about 1,350 
bits per second. 

The UR ITE command writes one extra value on the tape after it 
has written the values In the memory range. This extra vaiue is 
the checksum, which is the eight-bit partial sum of all values in 
the range. When the Monitor reads the tape, it uses this value to 
determine if the data has been written and read correctly (see 
below). 



Reading Data from Tape 

Once you've saved a memory range onto tape with the Monitor's 
WRITE command, you can read that memory range back into the 
computer by using the Monitor's REftD command. The data values 
you ve stored on the tape need not be read back into the same 
memory range from whence they came; you can tell the Monitor 
to put those values into any memory range in the computer's 
memory, provided that it's the same size as the range you 
saved. The format of the READ command is the same as that of 
the WRITE command, except that the command letter is 

{start} . {end} R 
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Once again, after typing the command, don't press | RETURN] . 
Instead, start the tape recorder in play mode and wait a few 
seconds. Although the WHITE command puts a ten-second leader 
tone on the beginning of the tape, the R£flD command needs only 
three seconds of this leader to lock on to the signal from the 
tape. You shouid let a few seconds of tape go by before you 
press |_R ETURIh1 to allow the tape recorder's output to settle down 
to a steady tone. 

This example has two parts. First, you set a range of memory to 
zero, verily the contents of memory and then type the READ 
command, but don't press | return] . 
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Now start I he casset te running in play mode, wait a few seconds, 
and press | RETURN ] . After the Monitor sounds the hell (beep) and 
displays the prompt, eicamine the range of memory to see that 
the values from the tape w^re read correctly: 



*0,14 
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After the Monitor has read all the data values on the tape, it 
reads the checksum value It computes the checksum on the 
data it read and compares it to the checksum from the tape. If 
the two checksums differ, the Monitor sends a beep to the 
speaker and displays "ERR". This warns you that there was a 
problem reading the tape and that the values stored in memory 
aren't the values that were recorded on the tape. If the two 
checksums match, the Monitor will just send out a beep and 
display a prompt. 
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MisceUaneous Monitor Commands 



These Monitor commands enable you to change the video 
display format from normal to inverse and back, and to assign 
input and output to peripherals in expansion slots 



Display Inverse and Normal 

You can control the setting of the inverse- normal mask location 
used by the CDUT subroutine (described in Chapters) from the 
Monitor so that all of the Monitor's output wili be in inverse 
format. The INVERSE command, I, sets the mask such that all 
subsequent inputs and outputs are displayed in inverse format 
To switch the Monitor's output back to normal format, use the 
NORMi^L command, H. 
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Back to BASIC 



Usethe BASIC command. [ caHTROL J -B , to leave the Monitor and ET 



u 

J 



enter the BASIC thiat was active when you entered thie Monitor. 
NonDally, this is Applesoft BASIC, unless you deliberately 
switched to Integer BASIC. Any program or variables that you 
had previously in BASIC will be lost. If you want to re-enter 
BASIC with your previous program and variables intact, use the 
CONTINUE BAS iccommand, fcD NTRaL~| -c . If you ar e using th e 
Apple Disk Operating System (DOS), pressf caNTRQLj - 1 RESET | or 

3D0G 

to return to the language you were using, with your program and 
variables intact. 

II you type the latter command, make sure that the third character 
you type is a zero, not a letter O, The letter G is the Monitor's GO 
command, de&cribed below in the section "Machine-language 
Programs". 



Redirecting fnpui and Outfyut 

The PR INTER command, aclivated by a TcnNTRaL ] -P , diverts all 
output normally destined for the screen to an interface card in a 
specified exapnsion slot, from 1 to 7. There must be an interface 
card in the specified slot, or you will lose control ot the computer 
and your program and variables may be lost. The format of the 
command is 



{slot number} I CONTROL |-P 

A PRINTER command to slot number will switch the stream of 
output characters back to the Apple lie's video display. 



Warning 

Don't give the ph Inter command with slot number to deactivate the 
80-column firmware, even though you used this command to 
activate il in slot 3. The command works, but it just disconnects the 
firmware, leaving some of the soft-switches set tor 80-column 
display. 
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In much the same way that the PRINTER command switches the 
output stream, the keybdard command substitutes the interlace 
card in a specified expansion slot for the Apple lie's normal input 
device, the keyboard. The format for the kevbqard command is: 



{slot number} | control |-k 

A slot number of for the kEVEOARD command directs the Monitor 
to accept input from the Apple lie's buitt-in keyboard. 

The PR INTER and KEYBOARD commands are the exact equivalents of 
the BASIC commands PR' and in*. For more information on the 
way those commands work, refer to the section ' The Standard I/O 
Links" in Chapter 3. 

Hexadecimai Arithmetic 

The Monitor will also perform one-byte hexadecimal addition and 
subtraction. Just type a tine in one of these formats: 

{value} + {value} 
{value} - {value} 

The Apple Me performs the arithmetic and displays the result, as 
shown in these examples; 

•20+13 

-33 

*4A-C 

-3E 

•FF + 4 

-03 

•3-4 

-FF 
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Special Tricks with the Monitor J 

This section describes some more complex ways of using the 
Monitor commands. 

Multiple Command Lines 
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00 00 00 00 00 00 
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Jf the Monitor encounters a character in the input line that it does 
not recognize as either a hexadecimal digit or a valid command 
character, it executes all the commands on the input line up to 
that character, then grinds to a halt with a noisy beep and 
ignores the remainder of the input iine. 



Fi fling Memory 

The MOVE command can be used to replicate a pattern of values 
throughout a range of memory. To do this, first store the pattern 
in the first locations in the range: 



• 300:11 22 33 
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You can put as many Monitor commands on a single line as you 
like, as long as you separate them with spaces and the total 
number of characters in the line is less than 254. Adjacent 
single-letter commands such as l. s, I. and n need not be J 
separated by spaces. j^J 

You can freely intermix all of the commands except the store (: ) ^ 
command. Since the Monttor takes all values following a colon 
and places them in consecutive memory locations, the last value 
in a STORE must be followed by a letter command before another 
address is encountered, Vou can use the normal command as the 
required letter command in such cases; it usually has no effect 
and can be used anywhere. 

In the following example, you display a range of memory, change 
it. and display it again, all with one line of commands. 

^ 300.307 300:18 69 1 N 300.302 



li 

Urn 




Remember the number of values in the pattern: in this case, it is 
3. Use ttie number to compute addresses for the MOVE command, 
like this: 

{start+number} < {start} . {end-number} M 

This r^OVE command will first replicate the pattern at the locations 
immediately following the original pattern, then replicate that 
pattern following itself, and so on until it tills the entire range. 

*303<300.32Dfyl 
•300,32F 

0300- n £2 33 11 22 33 n 22 

0308- 33 11 22 33 11 22 33 11 

0310- EE 33 11 £2 33 11 22 33 

031 a- 1 1 22 33 11 22 33 11 22 

0320- 33 11 22 33 1 1 22 33 1 1 

0323- 22 33 11 22 33 11 22 33 



You can do a similar trick wtth the VERIFY command to check 
whether a pattern repeats itself through memory. This is 
especially useful to verify that a given range of memory locations 
all contain the same value. In this example^-you first fill the 
memory range from *30 to *320 with zeros and verify it. then 
change one location and verify again, to see the VERIFY 
command detect the discrepancy: 

* 300:0 

*301 <300.31FIVI 
•30K300.31FV 

•304:02 

•301 <300.31 FV 

0303- 00 1025 

0304- 02 too) 
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Repeating Commands 

You can create a command line that repeats one or more 
commands over and over You do this by beginning the part of 
the command line that you want to repeat with a letter command, 
such as N. and ending it with the sequence 34: n, where n is a 
hexadecimal number that specifies the position in the line of the 
command where you want to start repeating; for the first 
character in the line. n-0. The value for n must be followed with 
a space in order for the loop to work properly. 

This trick takes advantage of the fact that the Monitor uses an 
index register to step through the input buffer starting at location 
t£00 . Each time the Monitor executes a command, it stores the 
value of the index at location »3^; when that command is 
finished, the Monitor reloads the index register with the value at 
location *34. By making the last command change the value at 
location *34, you change this index so that the Monitor picks up 
the next command character from an earlier point in the buffer 



The only way to stop a loop like this is to press [ contr^ - 
[ RESET I ; that is how this example ends 
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Creating your Own Commands 

The USER command J_c ONTRaL | -y , forces the Monitor to jump to 
memory location *3FB, You can put a JMP instruction there that 
jumps to your own machine-ianguage program. Your program 
can then examine the Monitor's registers and pointers or the 
input buffer itself to obtain its data. For example, here is a 
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program th at displays everything on the input line after the 

I C0NTR0l1 "Y . The program starts at location taoo; the command 

line that starts with *3Fa stores a jump to *300 at location *3r8. 

*300:A4 34 B9 00 02 20 ED FD C8 C9 8D DO F5 4C 69 Ff 
*3F8:4C 00 03 

* rcQNTRDL l -Y THIS IS A TEST 
THIS rs ft TEST 

Machine-Language Programs 

The main reason to program in machine language is to get more 
speed. A program in machine language can run much faster than 
the same program written in high-level languages such as BASIC 
or Pascal, but the machine-language version usually takes a lot 
longer to write. There are other reasons to use machine 
language; you might want your program to do something that 
isn't included in your high-level language, or you might just enjoy 
the challenge of using machine language to work directly on the 
bits and bytes. 

If you have never used machine language before, you'll need to 
learn the 6502 insinjc^ions listed In Appendix A To become 
proficient at programming In machine language, you'll have to spend 
some lime at il, and sludy one of the books on 6502 pni^grammiog 
lifted In the Bibliography. 

You can gel a hexadecimal dump of your program, move it 
around in memory, or save it on tape and recall it again using 
the commands described in the previous sections. The Monitor 
commands in this section are intended specifically for you to use 
in creating, writing, and debugging machine-language programs. 



Running a Program 

The Monitor command you use to start execution of your 
machine-language program is the GU command. When you type 
an address and the letter G, the Apple lie starts executing 
machine language instructions starting at the specified location. If 
you just type the execution starts at the last opened iocation. 



Machine-language Programs 




The Monitor treats this program as a subroutine: it should end 
with an RTs (return from subroutine) instruction to transfer control 
back to the Monitor, 

The Monitor has some special features that make It easier for 
you to write and debug machine-language programs, but before 
you get into that, here is a small machine-language program that 
you can run using only the simple Monitor commands already 
described. The program in the example merely displays the 
letters A through Z: you store it starting at location *300, examine 
it to be sure you typed it correctly, then type 300G io start it 
running, 

i>300:A9 CI 20 ED FD 18 69 1 C9 DB DO F6 60 
•300 30C 

03QO- A9 C1 20 ED FD 18 69 01 
0308- C9 DB DO F6 60 

•300G 

AaCDEFGHlJKLriNOPaRSTUVWXYZ 
* 



6- 



Since programs that translate assembly 
language ioEo machine language are 
called assemblers, a prog rami like the 
Morilor's u i st command Ihat translates 
machine language into asssmbiy 
larguag'B is called a disassembler. 



Disassembled Programs 

Machine-language code in hexadecimal isn't the easiest thing in 
the world to read and understand. To make this job a little 
easier, machine-language programs are usually written in 
assembly language and converted into machine-language code 
by programs caHed assemblers. 



The word mnemonic comes from the 
same root as memory and re(ers to 
short acronyms thai are easier to 
remember than tlie hexadecimal 
operation codes themselves: lor 
example, for clear carry you write CLC 
instead ot > i Q. 



The Monitor's LIST command displays machine-language code in 
assembly-language form. Instead of unformatted hexadecimal 
gibberish, the L[ST command displays each instruction on a 
separate line, with a three-tetter instruction name, or mnemonic, 
and a formatted hexadedmat operand The list command also 
converts the relative addresses used in branch instaictions to 
absolute addresses. 



108 



Using the Monitor 



The Monitor LIST command has the format: 



{tocation} L 

The LIST command starts at the specified location and displays 
as much memory as it takes to make up a screenful! (20 lines) of 
instructions, as shown in the following example: 



*300L 










0300- 


A3 


CI 


LDfl 




0302- 


20 


£D FD 


JSR 


*FDED 


0305- 


18 




CLC 




0306- 


69 


01 


ADC 


'*01 


0308- 


CS 


DQ 


CMP 


'«DB 


030A- 


DO 


F6 


BNE 


*030e 


030C- 


60 




RTS 




030D- 


00 




BRK 




030E- 


00 




BRK 




030F- 


00 




BRK 




031 0- 


00 




B^K 




0311- 


00 




BRK 




0312- 


00 




BRK 




031 3- 


00 








0314- 


QO 




B4?K 




0315- 


00 




BRK 




0316- 


00 




BRK 




0317- 







BRK 




03ie- 


DO 




BRK 




0319- 


00 




BRK 





The first seven lines of this example are the assembly-language 
form of the program you typed In the previous example. Tne rest 
of the lines are BRK instructions only if this part of memory has 
zeros in it: other values will be disassembled as other 
instructions. 

The Monitor saves the address that you specify in the LIST 
command, but not as the last opened location used by the other 
commands. Instead, the Monitor saves this address as the 
program counter, which it uses only to point to locations within 
programs. Whenever the Monitor performs a LIST command, it 
sets the program counter to point to the location immediately 
foilowing the last location displayed on the screen, so that if you 
type another List command it will display another screenfull of 
instructions, starting where the previous display 
left off. 



Machine-language Programs 
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The Mini-assembler 

Without an assembler, you have to write your machine language 
program, take the hexadecimal values for the opcodes and 
operands, and store them in memory using the commands 
covered in the previous sections. That is exactly what you did 
when you ran the previous exampfes. 

The integer BASIC interpreter includes an assembler called the 
Apple Mini-assembler that enables you to type programs into the 
Apple lie using the same assembly-language format that the LIST 
command displays. It Is called a mini -assembler because it 
doesn't include symbolic labels, an important feature of all full- 
sized assemblers like the Assembler/Editor in the DOS Tool Kit 
(Apple product number A2D0029). 

Before you can use The Mini-assembler, the Apple Me has to be 
running Integer BASIC. When you start up the computer using 
DOS or either BASIC, the Apple lie loads the Integer BASIC 
interpreter from the file named INTbAS IC into the bank switched 
RAM. 

To run Integer BASIC after you have started up the computer 
with DOS, type 



IHT 



The Apple lie displays the Integer prompt character 
cursor. 



and a 



If you have nol activated the SO-calumn firmware since you started 
up with DOS, the cursor now looks like a blinking rectangle: it is 
actually a space character displayed In flashing formal. This is 
ewidence that the old Monitor is operating {see Chapter 3). The old 
f\^1onitor is loaded Into RAM along with Integer BASIC and the mini- 
assemblef: the next time you activate the eo-coiumn firmware, it 
copies the current version of the Monitor from ROM into RAM. Once 
this has happened, the current Monitor is active even with Integer 
BASIC, and the cursor is either a blinking checkerboard or a steady 
rectangle. 

Now enter the Monitor by typing 



CALL -151 
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4*1- 

J 



After you enter the Monitor from Integer BASIC, invoke the Mini- 
assembler by typing: 

FB6B& 

This is just the 00 command described above starting the 
program stored at location *F6GS — the mini assembier. You can 
tell that the mini-assembler is running because it displays an 
exdamalion point {' ) as its prompt character. While the mini- 
assembler is running, you can execute any Monitor command by 
preceding it with a dollar sign {*). Aside from that, the Mini- 
assembler has an instruction set and syntax all its own. 

The Mini-assembler saves one address, that of the program 
counter. Before you start to type a program, you must set the 
program counter to point to the location where you want the Mini- 
assembler to store your program. Do this by typing the address 
followed by a colon. 

After the colon, type the mnemonic for the first instruction in your 
program, followed by a space and the operand of the instruction 
(formats for operands are listed Table 5-1). Now press [ return J . 
The Mini-assembler converts the line you typed into hexadecimal, 
stores it in memory beginning at the location of the Program 
Counter, and then disassembles it again and displays the 
disassembled line. It then displays a prompt on the next line. 

Now the Mini-assembler is ready to accept the second instruction 
in your program. To tell it that you want the next instnjction to 
follow the first, don t type an address or a colon: just type a 
space and the n ext instruction's mnemonic and operand, then 
press [ RETURN | . The Mini-assembler assembles that line and waits 
for another. 

If the line you type has an error fn it, the Mini-assembler beeps 
loudly and displays a circumflex under or near the offending 
character in the input line Most common errors are the result of 
typographical mistakes: misspelled mnemonics, missing 
parentheses, and so forth. The Mini-assembler also rejects the 
input line if you forget the space before or after a mnemonic or 
include an extraneous character in a hexadecimal value or 
address. It the destination address of a branch instruction is out 
of the range of the branch (more than 127 tocations distant from 
the address of the instruction), the Mini-assembler flags this as 
an error. 
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■300:LDX #02 

0300- A£ 02 LDX '»0S 

! LDA $0<X 

0302- BB OD LDA tOO.X 

1 STA $10,X 

0304- 95 10 STfl t10,X 

• OEX 

0306' CA DtX 
! STA $C030 

0307- 9D 30 CO STA *C030 
! BPL $302 

Q30A- 10 FB BPL »0302 

! BRK 

03CC- 00 BRK 



There are two ways to leave the Mini-assembter and re-enter the 
Monitor. One way is to type the Monitor command, FF690, 
preceded by a dollar sign; 



!$FFG9G 



Another way to leave the Mini-assembler is to press I CONTROL 
[ RESET ] , which warm-Starts BASIC^ then type 



CALL-151 
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Your assembly language program is now stored in memory. You 
can display it with the list command: 



•30DL 










0300- 


Pi2 


02 


LDX 




0302- 


BS 


00 


LDA 


soo,x 


0304- 


95 


10 


STA 


1 1 » X 


0306- 


Cfl 




DEX 




0307- 


3D 


30 CO 


STfl 


«C030 


030ft- 


1 


F6 


BPL 


S03OE 


030C- 


00 




BRK 




030D- 


00 




BRK 




030E- 


OD 




BRK 




030F- 


00 




BRK 




031 0- 


00 




BRK 




031 1- 


00 




BRK 




0312- 


00 




BRK 




031 3- 


00 




BRK 




031 4- 


00 




BRK 




0315- 


00 




BRK 




031 G- 


DO 




BRK 




031 7- 


00 




BRK 




031 e- 


00 




BRK 




0319- 


00 




BRK 





Mini-assembler Instruction Formats 

The Apple Mini-assembler recognizes 56 mnemonics and 13 
addressing formats used in 6502 assembiy-langgage 
programming. The mnemonics are standard, as used in the 
Synertek Programming Manual (Appie part number A2L0003). but 
the addressing formats are somewhat different. Table 5-1 shows 
the Apple standard address-mode formats for 6502 assembly 
language. 

An address consists of one or more hexadecimal digits. The 
Mini-assembler interprets addresses the same way the Monitor 
does: If an address has fewer than four digits, the Mini-assembler 
adds leading zeros; if the address has more than four digits, then 
it uses only the last four. 

In this bcx3k, dolSar sigrts ) in addresses signify that the addresses 
are in hexadecimal notation. They are ignored by the Mini- 
assembler and may be omitted when typing programs. 

There is no syntactical distinction between the absolute and zero- 
page addressing modes. If you give an instruction to the Mini- 
assembler that can be used in both absolute and zero-page 
mode, the Mini-assembler assembles that instruction in absolute 
mode if the operand for that instruction is greater than *ff, and it 
assembles it in zero-page mode if the operand is less than $100. 
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Table 5-1 Mini-assembler Address 
Formal s 

"Wole: Accumulator and 
Implled-address insflnjctions have no 
operands. 



Addressing Mode 

AccumjJator 

Implied 

Immediate 

Absolute 

Zeropaga 

Indexed zero page 

Indexed absolute 

Relative 
IndeKed indirect 
Indirect indexec! 
Absolute indirect 



Format 



Notes 



t{ address [ 

({address I 

I [address}, X 
({address], ¥ 

■({address}, X 
({address}, V 

*{ address } 

(s{ address x) 

(*{ address [), Y 

(({address}) 



Instructions in accumulator mode and impiied addressing mode 
need no operands. 

Brancti instructions, which use the relative addressing mode, 
require the target address of the branch. The Mini-assembler 
calculates the relative distance to use in the instruction 
automatically. If the target address is more than 127 locations 
distant from the instruction, the Mini-assembler sounds a beJI 
(beep), displays a circumflex {*) under the target address, and 
does not assemble the line. 

If you give the Mini-assembler the mnemonic for an instruction 
and an operand, and the addressing mode of the operand cannot 
be used with the instruction you entered^ the Mrni-assembier wilt 
not accept the line. 
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Summary of Monitor Commands 

Here is a summary of the Monitor commands, showing the 
syntax diagram for each one. The Mini-assembler commands are 
included, even though they are only available when Integer 
BASIC is active (see the section 'The Mini-assembler"). 

Examining Memory 



{adrs} 

{adrs1},{adrs2} 
[ RETURN I 



Examines the value contained 
in one location. 

Displays the vafues contained 
in all locations between 
{adrsl} and {adrs2}. 

Displays the values in up to 
eight locations following the 
fast opened location. 



Changrng the Contents of Memory 

{adrs}:{val} {val},.. Stores the values in 

consecutive memory locations 
starting at {adrs}. 

;{val}{vai}... Stores values in memory 

starting at the next changeable 
location. 



Moving and Comparing 

{dest}<{start}.{enctjM 

{d9st}<{start}.{end}v 



Copies the values in the range 
{start}. {end} into the range 
beginning at {dest}. 

Compares the values in the 
range {start}. {end} to those in 
the range beginning at {dest). 
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The Register Command 
[^□NTRQLj-E 



Displays the locations where 
the contents d the 6502"s 
registers are stored and opens 
tinem for changing. 



Cassette Tape Commands 

-[start|.{end}W 

{start}. {end>R 



Writes the values in the 
memory range {start}. {end} 
orito tape, preceded by a ten- 
second leader. 

Reads values from tape> 
storing them in memory 
beginning at {start} and 
stopping at {end}. Prints "ERR" 
if an error occurs. 



Miscellaneous Monitor Commands 



I 
N 

L cdhtr dlI -b 

rCQHTRQL [ ~C 

{val} + {val} 
{val}-{val} 



Sets Inverse display mode. 

Sets Normal display mode. 

Enters the language currently 
active {usually Applesoft). 

Returns to the language 
currently active (usually 
Applesoft). 

Adds the two values and prints 
the hexadecimal result. 

Subtracts the second value 
from the first and prints the 
result. 
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{slot} [ CDNTRDL \ -P Diverts output to the device 

whose interface card ib in slot 
number {slot}, tf ^slotHOn 
accepts input from the 
keyboard. 



CONTROL I - y Jumps to the machine 

language subroutine at location 



Running and Lrsting Programs 

{adr£}G 

{adrs|L 



Transfers control to the 
machine language program 
beginning at {adrsK 

Disassembles and displays 20 
instructions, starting at {adrs}. 
Subsequent L s display 20 
more instructions. 



The Mini-assembler 



The Mini-assembler is only awailable FGGSG 
when Integer BASIC i& active. 



*{ command 



Invokes the Mini-assembler, 

Executes a Monitor command 
from the Mini-assembler. 



IFFS9G 



Leaves the Mini-assembler. 
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Chapter 6 

Programming for 
Peripheral Cards 



The seven expansion slots on the Apple lie's main circuit board 
are used for installing circuit cards containing the hardware and 
firmware needed to interface peripheral devices to the Apple lie. 
These slots are not simple I/O ports: peripheral cards can 
access the Apple lie s data, address, and control lines wia these 
slots. The expansion stots are numbered from 1 to 7, and certain 
signals, described below, are used to select a specific slot. 

Ttie older Apple II and Apple II Plus models have an eighth 
expansion slot: slot number 0. On those models, slot is normally 
used for a language card or a ROM card, the functions of the 
Apple 11 Language Card are buiH into the main circuit board of the 
Apple Me. 

Penpherahcard Memory Spaces 

Because the Appie lie's 6502 microprocessor does all of its l;'0 
through memory locations, portions of the Apple lie's memory 
space have been allocated for the exclusive use of the cards in 
the expansion slots, fn addition to the memory locations used tor 
actual I/O, there are memory spaces available for programmable 
memory (RAM) in the main memory and for read-only memory 
(ROM or PROM) on the peripheral cards themselves. 

The memory spaces allocated for the peripheral cards are 
described below. Those memory spaces are used for small 
dedicated programs such as I/O drivers. Peripheral cards that 
conlam their own driver routines in firmware like this are called 
intelligent peripherals. They make it possible for you to add 
peripheral hardware to your Apple lie without having to change 
your programs, provided that your programs follow normal 
practice for data input and output, 
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Table fi-1 Peripheral card I/O 
Memory Locatiorg 

Note; Th& enabling signal is marked 
with a prime, to indieate that il is an 
active-low signal. 



Peripheral-card IIO Space 

Each expansion slot has the exclusive use of sijcleen memorv 
locations for data input and output in the memory space 
beginning at iocation *C090. Slot 1 uses locations *CQ90 through 
*C09F, slot 2 uses locations *COflo through *C0AF, and so on 
through location «COFF, as shown in Table 6-1. 

These memory locations are used for different I/O functions, 
depending on the design of each peripheral card. Whenever the 
Apple Me addresses one of the sixteen I/O locations allocated to 
a particular slot, the signal on pin 41 of that slot, called device 
SELECT' , switches to the active (low) state. This signal can be 
used to enable logic on the peripheral card that uses the four 
low-order address tines to determine which of its sixteen I/O 
locations is being accessed. 



Slot 


Locations 


Enabled by 


1 


*C090-»C0SF 


DeVICE SELECT' 


2 


«C0flO-*CaAF 


DEVICESEILECT' 


3 


>COBO-*CDBF 


Device: select' 


4 


«COCO-*COCF 


DEVICE SELECT' 


5 


•CODO-*CODF 


DFVLCE SELECT' 


6 


<C0EO-*CDEF 


DEVICE SELECT' 


7 


tCOFO-*CQFF 


DEVICE SELECT' 



a 



Peripheraf-Qard ROM Space 

One 256-byte page of memory space is allocated to each ^ 
peripheral card. This space is normally used for read-only ^ 
memory (ROM or PROM) on the card with driver programs that 
control the operation of the peripheral device connected to the 
card. 

The page of memory allocated to each expansion slot begins at — ■ 

location scnOO, where n is the slot number, as shown in Table 6-2 

and Figure 6-3. Whenever the Apple Me addresses one of the jjj^ 



^22 Programming tor Peripheral Cards 



-I 



256 ROM memory locations allocated to a particular slot, the 
signal on pin 1 of that slot, called [^0 select switches to the 
active (low) state. This signal enables the ROM or PROM 
devices on the card, and the eight low-order address lines 
determine which of the 256 rniemory locations is being accessed. 



Table 6-2 Peripheral-card ROM 
Memory Locations 

Note: The enabling signal is marked 
with a prime, lo irsdicale iNal ii is an 
active-low signal. 



Slot 



Locations 



Enabled by 



1 


*CtQO-*ClFF 


I/O SELECT' 


2 




l/D SELECT' 


3 


*C300-*C3FF 


I/D SELECr 


4 


tC400-«C^FF 


[/□ SELECT' 


S 


*C50C-»CSFF 


I/D SELECT' 


G 


*CG00-*C6FF 


IJQ SELECT' 


7 


tC7aO-IC7FF 


1/Q SELECT' 



If there Is an BO-column text card in&talled in the auxiliary slot, some 
of the functions normafly associated with slot 3 are performed by 
the 80-column text card and the built-in 80-column firmware, With a 
80-column text card installed, the i/o select' sigfial is not available 
tor slot 3, so firmware in ROM on a card in slot 3 wiU not run. 



Expansion ROM Space 

In addition to the small areas of ROM memory allocated to each 
expansion slot, peripheral cards can use the 2K-b7te memory 
space from f CBOO to *cfff for larger programs in ROM or PROM 
This memory space is called expansion ROM space (see the 
memory map in Figure 6-3). Besides being larger, the expansion 
ROM memory space is always at the same locations regardless 
o1 which slot is occupted by the card, making programs that 
occupy this memory space easier to write. (See the section "lyo 
Programming Suggestions", below.) 

This memory space is available to any peripheral card that needs 
it. More than one peripheral card can have expansion ROM on it, 
but only one of them can be active at a time. 
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Each peripheral card that uses expansion ROM must have a 
circuit on it to enable the ROM. The circuit does this by a two- 
stage process: first, it sets a flip-flop when the 1/0 SELECT' signal, 
pin 1 on the slot, becomes active (low); second, it enables the 
expansion ROM devices when the l/D strobe ' signal, pin 20 on 
the slot, becomes active (low). Figure 6-1 shows a typical ROM- 
enable circuit. 

The 1/0 SELECT' signal on a particular slot becomes active 
whenever the Apple lie s 6502 microprocessor addresses a 
location in the 256-byte ROM address space allocated to that 
slot. The l/Q STROBE' signal on all of the expansion slots becomes 
active (low) when the 6502 addresses a location in the 
expansion-ROM memory space, fCBOO-$CFFF. The I/O STROBE' 
signal is used to enable the expansion-ROM devices on a 
peripheral card (see Figure 6-1). 

If there is an BO-column text card installed m the auxiliary slot, some 
of the functions nomnally associated with slot 3 are performed by 
the text card and tfie built-in 80-column firmware. With the text card 
Installed, the I/d strobe' slgnai i$ not available on slot 3, so firmware 
In expansion RDM on a card in slot 3 will not run. 

Figure 6>1 Expansion ROM Enable 
Cjrcjil 




(i o strobT} 



ADDRESS 



AO TO A10 



A program on a peripheral card can get exclusive use of the 
expansion ROM memory space by referring to location *cfff in 
Its initialization phase. This Jocation is special: all peripheral cards 
that use expansion ROM must recognize s reference to *CFFF as 
a signal to reset their ROM-enable flip flops and disabJe their 
expansion ROMs. Of course, doing so also disabies the 
expansion ROM on the card That is about to use il^ but the next 
instruction in the initialization code sets the flip-flop on the 
expansion-ROM enable circuit on the card. Once this has been 
done, this card has exclusive use of the expansion memory 
space and its program can jump directly into the expansion 
ROM. 

As described above, the expansion-ROM disable circuit resets 
the enable flip-flop whenever the 6502 addresses location *CFFF. 
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Figure 6-2 ROM Disable Address 
DecxxJIog 




To RESET. ROM enable 
flfp-fjop 



(i o strobe} 



To do this, the peripheral card must detect (he presence of *cfff 
on the address bus. You can use the uu strdse ' signal for part 
of the address decoding, since it is active for addresses from 
tcsoo through *CFFF. if you can afford to sacrifice sorrie ROM 
space, your can simplify the address decoding even further and 
save circuitry on the card. For exampie. if you give up the last 
256 bytes of expansion ROM space, your disable circuit only 
needs to detect addresses of the form *cfxx. and you can use 
the minimal disable-decoding circuitry shown in Figure 6-2. 



Peripheral-card RAM Space 

There are 56 bytes of main memory allocated to the peripheral 
cards, eight bytes per card, as shown in Table 6-3. These 56 
locations are actually in the RAM memory reserved for the text 
and low resolution graphics displays, but these particular 
locations are not displayed on the screen and their contents are 
not changed by the built-in output routine C0UT1 . Programs in 
ROM on peripheral cards use these locations tor temporary data 
storage. 



Table 6-^ Peripheral-card RAM 
MeiTiory Localions 

'Note: The RAM locations normally 
allocated to sbt 3 are taken aver by 
any card installed in the auKlliary slot 



Base 
Address 


1 


2 


Slot Number 
3" 4 


5 


6 


7 




*Q^79 


*0<7fl 


«047B* 


t047C 


»047D 


»047E 


t047F 






*04FA 


t04FB« 


t04FC 


f 04FD 


104FE 


*Q4FF 


*057B 






»057B* 


*057C 


»0b7D 


»0S7E 


«0S7F 


*D5Fe 


»0SF3 


lOSFA 


tOSFB* 


tOSFC 


fOSFD 


iOSFE 


tOSFF 


♦ □G7B 


»0679 


*0B7fl 


♦oe7B* 


$0S7C 




f067E 


»Q&7F 


iOGFB 


*06F3 


IDbFA 


tOSFB" 


*06FC 


«oeFD 


iOBFE 


*06FF 


♦ 0778 


to 779 


t077A 


*Q77B« 


ia77C 


*077D 


*Ci77E 


t[)77F 


»Q7Fe 


*07F9 


t07FA 


*Q7FB- 


t07FC 


*07FD 


S07FE 


<07rF 
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A program on a peripheral card can use the eight base 
addresses shown in the table to access the eight RAM locations 
allocated for its use, as shown in the next section, 'I/O 
Programming Suggestions". 

tlO Programming Suggestions 

A program In ROM on a peripheral card should work no matter 
which siot the card occupies. If the program includes a jump to 
an absolute location in one of the 256-byte memory spaces, then 
the card will only work when it is plugged into the siot that uses 
that memory space. If you are writing the program for a 
peripheral card that will be used by many people, you should 
avoid placing such a restriction on the use ot the card. 

To function properly no matter whfeh slot a peripheral card Is 
installed in, the prograni in ttie card s 256-byte memory space must 
not make any absotute references to itself Instead of using jump 
instructions, you should force conditions on branch instructions, 
which use relative addre^ing. 

The first thing a penpheral-cafd subroutine should do is to save 
the contents ot the 6502's registers. One way to do this is to use 
the monitor subroutine iDSftVE. This subroutine, which starts at 
location tFF4A, stores the registers in zero-page memory locations 
«4S-*4e. A companion subroutine, IDREST, restores the registers 
from these memory locations. Your program should cali lOREsT. 
which starts at location «FF3F Just before it returns control to the 
program that called it 

This method of saving the registers is convenient, but it is not 
always safe, If a second subroutine catls lOSAVE, or if an interrupt 
occurs, the new register contents get saved in the same 
locations, and the old ones get destroyed. It is safer, though 
somewhat slower, to save the registers on the stack, and restore 
them just before returning control to the calling program. 

Most single-character I/O is done via the 6502's accumulator. A 
character being output through your subroutine will be in the 
accumulator with its high bit set when your subroutine is called. 
Likewise, if your subroutine is performing character input, it must 
leave the character in the accumuiator with its high bit set when 
it returns to the calling program- 
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The memory addresses used by a program on a peripheral card 
differ depending on which expansion slot the card is installed in. 
Before it can refer to any of those addresses, the program must 
somehow determine the correct slot number. One way to do this 
is to execute a JSR (Jump to Subroutine) to a location with an RTS 
(Heturn from Subroutine) instruction in it, and then derive the slot 
number from the return address saved on the stack, as shown in 
the following example. 



PHP 

SCI 

JSR »FF5a 

TSX 

LDA (0100,X 
AND #*0F 
PLP 



save status 

inhibit interrupts 
-> a known RTS instruction 
gel high byte of the. . . 
...return address from stack 
low -order digit is slot no. 
restore status 



The slot number can now be used in addressing the memory 
allocated to the peripheral card, as shown below. 



I/O Addressing 

Once your peripheral-card program has the slot number, it can 
use it to address the I/O locations allocated to the slot. Table 6-4 
shows how these locations are related to sixteen base addresses 
starting with ICOBO. Notice that the difference Isetween the base 
address and the desired I/O location has the form *nO. where n 
is the slot number Starting with the slot number in the 
accumulator, the following example computes this difference by 
four left shifts, then loads it into an index register and uses the 
base address to specify one o1 sixteen ilO locations. 

ASL ; get n into. . . 

flSL \ 

flSL 

ASL 5 - ■ .hiqh-order nybble. . , 

TAX ; ... ot index register. 

LDA *COBG.X ; load from first !/□ location 



You must make sure that you get an appropriate value into the 
index register when you address I/O locations this way. For 
example, starting with 1 In the accumulator, the instructions in the 
above example perform an lda from location *C030, (he first UO 
location allocated to slot 1. If the value in Ifie accumulator fiad been 
0, the LDA would have accessed tocalion *C080, thereby setting the 
soft switch that selects the second bank of RAM at location *dqoo 
and enables it for reading (see Chapter 5). 
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Table 6^ Per[ph«r9l-card I/O Bas& 
Addresses 



Base 



Connector Number 



Address 


1 


2 


3 


4 


5 


8 


7 


tCDSO 


»C090 


SCOAO 


tCQBD 


• coco 


tCDDD 


ICOEO 


ICOTO 


tcoei 


*ca9i 




*C0B1 


*C0C1 


tCODi 


tCOEl 


icon 


tCD82 


»C092 


4C0A2 


SC0B2 


*C0C2 


*C0D2 






*C083 


iC093 


4C0ft3 


SC0B3 


*C0C3 


*CCD3 


JC0E3 


tCDF3 


*coe^ 






*CQB4 


tcnc4 


tCOD-* 


*C0E4 


*C0F4 


tC085 


tC095 


*C0A5 


*C0B5 


iCOGS 


tCODS 


*CDES 


*CDF5 


• C086 


*C09e 


*C0A6 


SCQB6 


tC0C6 


tCQD6 


tCOEG 


iCQFe 


*C087 


*C097 


*C0ft7 


*coa7 




»cnD7 


tC0E7 


»C0F7 


«C088 






tCOBS 


tCDCS 


IC0D8 


»C0E8 


iCOFS 


• C089 


*C099 


1C0A9 


*C0B9 




*C0D9 


»CDE9 


tCOFS 


tC08A 


*C09fi 


tCOAA 






tCCDA 


«COE^ 


tCQFA 


*C08B 


»C09B 


*COAB 


tCQBB 


tcncB 


tCCDB 


tCOEB 


tcaFB 


<cosc 


*C09C 


*noAC 


tCOBC 


(CDCC 


*CCDC 


CCOEC 


*COFC 


•coeD 


*C(19D 


tCOAD 


tCQBD 


tCOCD 


tCQDD 


tCOED 


iCOFD 


ICOBE 


*C{)9E 




tCOBE 


*COCE 


tCODE 


ICOEE 


fCOFE 


<coeF 


*C09F 


tCOAF 


SCQBF 


tcncF 


•CODF 


• GOEF 


»COFF 



a 

3 

5 



RAM Addressing 

A program on a peripheral card can use the eight base 
addresses shown in Table 6-3 to access the eight RAM locations 
allocated for its use. The program does this by putting its slot 
number into the Y index register and using indexed addressing 
mode with the base addresses. The base addresses can be 
defined as constants because they are the same no matter which 
slot the peripheral card occupies. 

If you start with the correct slot number in the accumulator (by 
using the example shown earlier), the following example uses ail 
eight RAM locations allocated to the slot. 



'J 
'J 
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TftY 

LDft •0 478. ¥ 

STA *0 4F8,V 

LDA S057B,¥ 

STA •05FB,Y 

LDft *0S78,V 

STA fOGF8,V 

LDft *0 77B,¥ 

STA *0 7F8.V 



Warning 

Peripheral card programs must not store data at the base-address 
locations ihemselves; the RAM at those locations is used by Ihe 
Disk Operating System. DOS stores the first byte of the ROM 
location of the expansion slot that is currently active (SCn) in 
location * 7fe. and the first byte of the ROM location of the slot 
holding the conlroller card for Ihe startup disk drive in location *5^B. 



Changing ihe Standard 110 Links 

There are two pairs of locations in the Apple lie that are used for 
controlling character input and output. They are called the 1,0 
links {see Chapters). In a Apple He running without a Disk 
Operating System, the I/O links normally contain the starting 
addresses of the standard input and output routines key IN and 
CQUT1 . If a disk operating system is running, one or both of the 
links will fiofd tfie addresses of the DOS input and output 
routines- 

The link at locations »3G and* 37 (decimal 54 and 55) is calEed csw. 
for Character output Switch. Individually, location *3B is called 
CSWL (CSW Low) and location *37 is called C5WH (csw High). This link 
hoJds the starling address of the subroutine the Apple lie is 
currently using for single character output. This address is 
normally *rDFO . the address of routine cauTi , described in 
Chapter 3. 



When you issue a PR'n from BASIC or an n fCQNTROL I -P from the 
Monitor the Apple tie changes this linl^ address to the first 
address m the ROM memory space allocated to slot number n. 
That address has the form *cnoo. Subsequent calls for character 
output are thus transferred to the program on the peripheral card. 
That program can use the instruction sequences given above to 
find its slot number and use the I/O and RAM locations allocated 
to it. When it is finished, the program can execute an Rts (Return 
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Irom Subroutine) instruction to return control to the calling 

program, or jump to the output routine cOUTi at location *fdFo to _ 

display the output character (which must be in the accumulator) ^ 

on the screen, then tet C0UT1 return to the calling program, . 

A similar link at locations *3a and *39 {decimal S6 and 57} is ^ 

called KSW, for Keyboard input Switch. Individualiy, location *3e is , 

called KSWL (for Ksui Low) and location * 39 is called kSWH (k Sw High). Jj 

Thts link holds the starling address of the routine currently being J* 
used for single-character input. This address is normally *fdib, 
the starling address of the standard input routine key IN (see 

Chapters). § 

When you iss ue an iN'n command from BASIC or an _J 

n rcD NTRDL [ -K from the monitor the Apple He changes this ^ 

link address to *CnOO, the beginning of the ROM memory space . 

that is allocated to slot number n Subsequent calls for character ^ 

input are thus transferred to the program on the peripheral card. ^ 
That program can use the instruction sequences given above to 

find its slot number and use the I/O and RAM locations allocated _; 

1o it. The program should put the input character, with its high bit t 
set, into the accumulator and execute an RTS (Return from 

Subroutine) instruction to return control to the program that ^ 

requested input. g 

When the Disk Operating System (DOS) is running, one or both ^ 

of the standard I/O links hold addresses of the Disk Operating ^ 

System's input and output routines. The DOS has internal 

locations that hold the addresses of the character input and 

output routines that are currently active. g 

If a program that is omning with DOS changes the standard link 

addresses, either directly ar via IH# and PR* commands. DOS is L 

discxinnected from the system. " 

To avoid disconnecting DOS each time they initiate I/O to a slot, £ 
BASIC programs that run with DOS must always issue an IN' or " 
a PR' command from inside a PR INT statement that starts with a 
1 COMTROL ] -t> Character. For assembly-language programs, there is £ 
a DOS subroutine call to use when changing the iink addresses. 
After changing csw or kSw. the program calls this subroutine at 
location *3EA (decimal 1 002). The subroutine transfers the link J 
address to a location inside DOS and then restores the DOS 
address in the standard link location. Refer to the section on 
input and output link registers in the DOS Manual for further 
details. 
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Using interrupts 



Although programs runnfng on the Appre Me do not normally use 
interrupts, it is possible to do so. To use interrupts on the 
Apple lie, your peripheral card must be able to send an interrupt 
request (IRQ') to the 5502 microprocessor, and you must store 
the address of your interrupt-handling routine in the user inlerrupt 
vector, as described below. 

fnterrupt priority is handled by a daisy-chain arrangement using 
two pins, INT IN and int out, on each expansion slot As 
described in Chapter 7, each peripheral card breal^s the chain 
when it makes an interrupt request. On peripherai cards that 
don't use interrupts, these pins should be connected together. 
The daisy chain gives priority to the peripheral card ir> siot 7: if 
this card opens the connection between IHT in and int out. or rf 
there is no card in this siot, interrupt requests from cards in slots 
1 through 6 can t get through. Simiiarly. slot 6 controls IRQ from 
siots 1 through 5, and so on down the iine. 

When the IRQ' line on the 6502 microprocessor Is activated 
(pulled low), the 6502 transfers controi through the vector in 
locations *FFFe'tFFFF. This vector is the address of the Monitor's 
interrupt handler, which determines whether the request is due to 
an external IRQ or a BRK instruction and transfers contro! to the 
appropriate routine via the vectors stored in memory page 3. The 
BRK vector is in iocations *3F0-*3Fi and the [RO vecJor is in 
locations *3FE-*3FF (see Table 4-10). The Monitor normaily stores 
the address of its reset routine In the I RQ vector; you should 
substitute the address of your program's interrupt-handling 
routine. 

Other Uses of 110 Memory Space 

The portion of memory space from location *cooo through *CFFF 
(decimal 49i S2 through B3347) is normaify allocated to I/O and 
program memory on the peripheral cards, but there are two other 
functions that also use this memory space; the buiit-in self-test 
firmware and the SO-coiumn display firmware. The soft switches 
that control the allocation of this memory space are described 
below. 



Oth^r Uses of I/O Memory Space 



Figure 5-3 I/O Memory Map 
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Switching HQ Memory 

The built-in firmware uses two soft switches to control the 
allocation of the I/O memory space from *C0OO to *CFFF. The 
locations of these soft switches. SLDTcxROr^ and slOTC3ROM, are 
given in Table 6-5. 

Like the display switches describetJ in Chapter 2, these soft switches 
share their locations with the keyboard data and strobe functions. 
The switches are activated only by writing, and the stales can be 
determined only by reading, as indicated in Table 6-5. 

Wlien SLOTCSRori is on^ the 256-byte ROM area at *C300 is 
available to a peripheral card in slot 3, which is the slot normally 
used for a terminal interface. It a card is installed in the auxiliary 
slot when you turn on the power or reset the Apple Me, the 
SLDTSRDM switch is turned off. Turning SLaTcaRD^t off disables 
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Table 6-5 I/O Memory Switches 



Name Function Localian Motes 

Hex Decimal 



SL0TC3RDM 


Slot ROM at *C3QD 


tCODB 


4die3 


-16373 


Write 




Internal ROM at 4 c 30 Q 




491 £2 


-1G374 


Write 




Head 5LDTC3HDM switch 


«C017 


491 75 


-163GI 


Read 


SLOTCKROM 


Slot ROM al «CxDD 




49159 


-1 G377 


Write 




Internal POM al SCxOQ 




491 SB 


-tG37B 


Write 




Read BLQTCXRan switch 




49173 


-1G3G3 


Read 



peripheral-card ROM in slot 3 and enables the built-in 80-column 
firmware, as shown in Figure 6-3. The eO-column firmware is 
assigned to siot-3 address space because slot 3 is normally used 
with a terminal interface, so the built-in firmware will work with 
programs that use slot 3 this way. 

Installing an SO-column text card in the auxiliary slot makes it 
impossible to run any peripheral card that has built-in firmware in 
slot 3. If an SD-colurnn tesrt card is not installed, a peripheral card In 
slot 3 ^lll work properly. 

The bus and I/O signals are always available to a peripheral 
card in slot 3, even when the eo-column hardware and firmware 
are operating. Thus it is always possible to use this slot for any 
I/O accessory that does not have built-in firmware. 

When SLOTCXROfi is active (high), the I/O memory space from 
•ci 00 to *C7FF is allocated to the expansion slots, as described 
previously. Setting SLDTcxROri inactive (low) disables the peripheral- 
card ROM and selects built-in ROM in all of the I/O memory 
space except the part from tCOOO to *CDFF (used for soft switches 
and data I/O), as shown in Figure 6-3. In addition to the 80- 
column firmware al *C300 and *ceoo^ the built-in BOM includes 
firmware that performs the setf-test of the Apple He's hardware. 

Setting slotckromi low enables built-in ROM in all of the I/O memory 
space (except the aoft-switch area), including the *C300 5pace, which 
contains the eo-coiumn: firmware. 
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Chapter 7 

Hardware Implementation 



Most of this manual describes functions — what the Apple tie 
does. This chapter, on the other hand, describes objects: the 
pieces of hardware the Apple lie uses to carry out its functions, 
tf you are designing a piece of peripheral hardware to attach to 
the Apple lie. or if you just want to know more about how the 
Apple Me is buplt, you should study thjs chapter. 

Environmental Specifications 

The Apple lie is quite sturdy when used in the way it was 
Intended. Table 7-1 defines the conditions under which the 
Apple lie is designed to function properly. 



J&b\e 7-1 Summary of Environmental 

Specificalions 



Uperating TemperaUrei 0' to 4&*C (30' !0 11 S'F) 
Helalive Humidity: 5% to 85% 

Une Voltage: 1 07 to 1 33 VAC 



You should treat the Apple Me with the same kind of care as any 
other electrical appliance. You should protect it from physical 
violence, such as harnmer blows or defenestration. You should 
protect the mechanical keyboard and the electrical connectors 
inside the case from spilled liquids, especially those with 
dissolved contaminants, such as coffee and cola drinks. 



In normal operation, enough air flows through the slots in the 
case to keep the insides from getting too hot, although some of 
the parts inside the Apple lie normally get rather warm to the 
touch. If you manage to overheat your Apple lie, by blocking the 
ventilation slots in the top and bottom tor example, the first 
symptom will be erratic operation. The memory devices in the 
Apple Me are sensitive to heat: when they get too hot, they 
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Table 7-2 Power Supply 
Specifications 

"Inlermitlent operaiion; The Apple lEe 
can safely operate for up to twenty 
minutes at the higher laad if tollDwed 
by at least ten minutes Si rvofmal 
load. 



occasionally change a bit of data. The exact result depends on 
what kind of program you are running and on just which bit of 
memory is affected- 

The Power Supply 

The power supply in the Apple He operates on normal household 
AC power and provides enough low-voHage electrical power 
for ttie built-in electronics plus a full complement of peripheral 
cards, including disk controller cards and comn^unications 
interfaces. The basic specifications of the power supply are listed 
in Table 7-2. 

The Apple He's power cord should be plugged into a three-wire 
110- to 120-volt outlet. You must connect the Apple Me to a 
grounded Outlet or to a good earth ground- Also, the line voltage 
must be in the range given in Table 7-2- If you try to operate the 
Apple Me from a power source with more than 140 voUs. you will 
damage the power supply. 



Line voltage: 

Maximum power consumption; 
Supply voltages: 



Mawmum supply currenis; 



Maximum case temperature: 



107V to 132V AC 

eOW c-ontinuous 
aow intermittent' 

+5V ±3% 
+ 11.8V ±6% 
-5 2V ±10% 

-lav ±10% 

+ 5V: 2.5A 
+12V; T.5A continuous, 
2_5A intermittent* 

-5V: 250mA 
-12V; 250mA 

55"C(130^F) 



The Apple Me uses a custom-designed switching -type power 
supply. It is smali and lightweight, and it generates less heat than 
other types of power supplies do. 

The Apple He's power supply works by converting th© AC line 
voftage to DC and using this DC voltage to power a vanable- 
frequency oscillator. The oscillator drives a small transformer with 
many separate windings to produce the different voltages 
required, A circuit compares the voltage of the -i-5-voil supply 
with a reference voltage and feeds an error signal back to the 
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oscillator circuit. The oscillator circuit uses the error stgnal to 
controt the frequency of its oscillation and keep the output 
voltages in their normal ranges. 

The power supply includes circuitry to protect itself and the other 
electronic parts of the Apple Me by turning off all four supply 
voltages whenever it delects one of the following malfunctions: 

■ any supply voltage short-circuited to ground; 

• the power-supply cable disconnected; 

* any supply voltage outside the normal range. 

Any time one of these malfunctions occurs, the protection circuit 
stops the oscillator, and all the output voltages drop to ^ero. After 
about half a second, the oscillator starts up again. If the 
malfunction is still occurring, the protection circuit stops the 
oscillator again. The power supply will continue to start and stop 
this way until the malfunction is corrected or the power is turned 
off. 




It you think the power supply is broken, do not altempt to repair it 
yourself. The power supply i$ in a sealed enclosure because some 
of its circuits are connected directly to the power line. Special 
equipment is needed to repair the power supply safely, so see your 
Apple dealer for service. 



The Power Connector 

The cable from the power supply is connected to the main circuit 
board by a six-pin connector with a strain-relief catch. The 
connector pins are identified in Table 7-3 and Figure 7-1 4d. 



Table 7'3 Power Connector Signal 
Speclficatlaris 



Pin Number 



Name 



Description 



1^ 
3 
4 
5 



Ground Common electrical ground 

+5V +5V Ifom power suppjy 

+12V +12V from power supply 

- 1 2V - 1 2V from power suppfy 

-5V -5V trom power supply 
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The 6502 Microprocessor 

The Apple lie uses a 6502B microprocessor as its central 
processing unit (CPU). The 6502B in the Apple lie runs at a 
clock rate of 1 .023 MHz and performs up to 500,000 eight-bit 
operations per second:. You should not us$ the clock rate as a 
criterion for comparing drfferent types of microprocessors. The 
6502 has a simpler instruction cycle than most other 
microprocessors and it uses instruction pipelining for faster 
processing. The speed of the 6502 with a 1 MHz clock is 
equivalent to other types of microprocessors with clock rates up 
to 2.5MH2. 

The 6502 has a sixteen-bit address bus, giving it an address 
space of 64K (2 to the sixteenth power or 65536) bytes. The 
Apple He uses special techniques to address a total of more than 
64K: see the sections "Bank -switched Memory" and "Auxiliary 
Memory and Firmware ' in Chapter 4 and the section "Switching 
I/O Memory" in Chapter 6. 



Table 7-4 6502 Microprocessor 
Specifications 



Type: 



6502B 



Regis-ter complement; Accumulator (A) 



Indait R&gistars (X, Y) 
Slack Pointer [Si 
Processor Stalus (P) 



Register stze: 



Eight bits 



Data JjLs: 



Eight bits wide 



Address bus: 



Sixteen bils wtde 



Address range: 



65.536 (64K) 



lr>terrijpl&: 



IRQ (maskable) 
NMI (normas-kable) 
BRK (programmed) 



Operating voiltage 



+5V (± 5%) 



Power dissipation 



SQDmW (typical) 



140 



Hardware Irriplenrieiilation 



6502 Timing 

The operation of the Apple lie is controlled by a set of 
synchronous liming sfgnafs, sometimes called clock signals. In 
electronics, the word cfock is used to identify signals that control 
the timing of circuit operations. The Apple He doesn't contain the 
kind of clock you tell time by, although its internal timing is 
accurate enough that a program running on the Apple He can 
simulate such a clock. 

The frequency of the oscillator that generates the master timing 
signal is 14.31818 MHz, Circuitry in the Apple lie uses this clock 
signal, called i 4ri, to produce all the other timing signals. These 
timing signals perform two major tasks; controilmg the computing 
functions, and generating the video display. The timing signals 
directly Involved with the operation of the 6502 are described In 
this section. Other timing signals are described in the sections 
■'RAM Addressing". "Video Display Modes", and "The Expansion 
Siots'\ 

The main 6502 timing signals are listed in Table 7-5. and their 
relationships are diagrammed in Figure 7-1 . The 6502 clock 
signais are and 4*0, compiementary signals at a frequency of 
1.02273 MHz. If you need more information about the 6502 itself, 
refer to the Synertek Hardware Manual (Apple product number 
A2L0002). The Apple lie signal named (fro is equivalent to the 
signai called f/>2 In the hardware manual (it isn't identical: it's a 
tiny bit early). 



Signal Name 


□escription 


1 4n 


Master oscillator. I4.3ieie MHc; also BO-coiumn dot cfock. 


7M 


fntermediare timing signal and 40-column dot dock. 


Q3 


JrHerTne<liaEe limfng signal, 2,04545 MHz with asymmetrical duty 




cycle. 


r&O 


Phase ot B502 clock. 1 .022727 MHz: Complement of <jy\. 


*1 


Phase t of 6502 clock. 1 .022727 MHz; Compremenl ot ifrC. 



The G502 Microprocessor 



141 



Figurfl7-1 6502 Timing Signals 
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The operations of the 6502 are related to the clock signals in a 
simple way: address during ^1. data during if>o. The 6502 puts 
an address on the address bus during c/jI. This address is valid 
not later than 11 D nanoseconds after goes high and remains 
valid through all of (i>o. The 6502 reads or writes data during t/io. 
If the S502 is writing, the read/write signal is low during 6o and 
the B502 puts data on the data bus. The data is valid not later 
than 75 nanoseconds after Oo goes high. \i the 6502 is reading, 
the read/write signal remains high. Data on the data bus must be 
valid no later than 50 nanoseconds before the end o1 cf^o. 
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Hardware Implementation 



The Custom Integrated Circuits 



Most of the circuitry that controls memorv and I/O addressing in 
the Apple lie is in three custom integrated circuits called the 
Memory Management Unit (MMU). the Input-Output Unit (lOU), 
and the Programmed Array Logic device (PAL). TUe soft switches 
used for controlling the various I/O and addressing modes of tfie 
Apple He are addressable flags inside the MMU and the lOU. 
The functions of these two devices are not as independent as 
their names suggest; working together, they generate all of the 
addressing signals. For exampfe, the MMU generates the 
address signals tor Ihe CPU, while the lOU generates similar 
address signals for the video display. 



Figure 7-2 ITib MMU Pinouts 
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The Memory Management Unit 

The circuitry inside the tJ\f>A\J implements these soft switches, 
which are described in the following chapters: 

Page 2 display [PAGE2): Chapter 2 

Hi res mode {h ires): Chapter 2 

Store to eO-column card (SOSTORE): Chapter 2 

Seiect bank 2: Chapter 4 

Enable bank switched RAM: Chapter 4 

Read auxiliary memory (R^ihRD): Chapter 4 

Write auxiliary memory (R/^r^wRT): Chapter 4 

Auxiliary stack and zero page (ALTZP): Chapter 4 

Slo! ROM for connector #3 (SLDTC3R0n): Chapter 6 

Slot ROM in I/O space (SLOTcxROn): Chapters 

The 64K dynamic RAMs used in the Apple lie use a multiplexed 
address, as described below in the section "Dynamic-RAM Timing" 
The MMU generates this multiplexed address for memory reading 
and writing by the 6502 CPU. 
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Table T-6 The MIVIU Signal Pin Number Name OescriptJon 

Descnptions — 
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MuitipiexQd address output 


14 


R/U' 


6502 read-wF^te control signal 


IS 


IHH' 


Inhibits main memory 


16 


DMA 


Controia dala bus for DMA transfers 


17 


ENBQ' 


Enables auxiiiary RAM 


ia 


KBD' 


Enables keyboard data bit 0-6 


19 




Enables bjilt-in firmware ROM #2 


20 


ROMEHI 
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Figure 7-3 The lOU Pinouts 
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The InputlOutput Unit 

The circuitry inside the Input/Output Unit (lOU) implements the 
foJIowing soft switches^ all described in Chapter 2; 

Page 2 display (PflGE2) 

Hi-res mode (hires) 

Text mode (text) 

Mixed mode (mued) 

80-C0lumn display (80CDL) 

Character-set select (Altcharset) 

/Vny-key-down 

Annunciators 

Vertical blanking (VBU) 

The 64K dynamic RAMs used In the Apple lie require a multiplexed 
address, as described below in the section "Dynamic-RAM Timing 
The lOU generates this multiplexed address for the data transfers 
required for display and memory refresh during dock phase 1 The 
way this address is generated is described below in the section 
"Video Display Generation", 
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Table 7-7 The lOU Signal 
Oescnptions 

Kote: Pin 1S is not ccriinect$d 
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Video display control bits 
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Display blanking signal 
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Display synchronization signal 
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Display horizontal tming signal 
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The PAL Circuit 



A Programmed Array Logic device, type PAL 16RS. generates 
several timing and control signals in the Apple lie. These signals 
are listed in Table 7-8. 



Table 7-8 The PAL Signal 
Oescripiions 



Figure 7-* The PAL PirtOtHs 
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Pin Numbsr 


Name 


□«acrtption 


1 


1 


1 4,31 81 8 MHz master timing signal 


2 


7M 


7.15909 MHz liming' signal 


3 


3.5QH 


3,579545 MHz timing signal 


4- 


HQ 


Horizontal video timing signal 
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Video data bit 7 
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Video timing signal 
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Video display grap^iics-nniode enable 
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RAM enable (CAS enable) 
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Enable flO-column Oisplay mode 


to 
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Video shift- register load enable 
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Memory Addressing 

The 6502 microprocessor can address 65.536 locations. The 
Apple Me uses this entire address space, and then some; some 
areas in memory are used for more than one function. The 
following sections describe the memory devices used in the 
Apple ile and the way they are addressed. Input and output also 
use portions of the memory address space; refer to the section 
"Peripheral-card Memory Spaces" in Chapter 6 for information. 



ROM Addressing 

In the Apple lie. the following programs are permanently stored in 
two type 2364 8K by B-bit flOMs (read-only memory): 



• Applesoft editor and interpreter 

• Monitor 

• eo-column display firmware 

• Seif-test routines 



These two ROMs are enabled by two signals called ROtiEN^ and 
RamENS. The ROM enabled by rdmeni , sometimes called the 
Diagnostics ROM, occupces the memory address space from 
1C1 00 to*DFFF. The address space from *C3O0 to*C3FF and from 
scaao to *CFFF contains the SO-column display fimiware. Those 
address spaces are normally assigned to ROM on a peripheral 
card in slot 3; for a discussion of Ihe way the SO-coiumn 
firmware overrides the peripheral card, see the section "Other 
Uses of I/O Memory Space" in Chapter 6, 

Two other portions of the Diagnostics ROM, addressed from 
«C1 00 to*C2FF and from*C400 to *C7FF, contain the built-in self-test 
routines. These address spaces are normaHy assigned to the 
peripheral cards; when the seif-test programs are running, the 
peripheral cards are disabled. 

The remainder of the Diagnostics ROM, addressed from *D0O0 to 
♦DFFF, contains part of the Applesoft BASIC interpreter. 

The ROM enabled by R0nEN2, sometimes called the Monitor ROM, 
occupies the memory address space from *E000 to »ffff. This 
ROM contains the rest of the Applesoft interpreter, in the address 
space from «E0O0 to *efff, and the Monitor subroutines, from 
«FOOO to fFFFF. 
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Figure 7-5 The 2364 HQU Pinouts 
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Rgufe7-6 The 2316 ROM Phnouls 
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Figure?-/ The 2333 ROM Pinouls 
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The other ROMs in the Apple lie are a type 2316 ROM used for 
the keyboard character deccder and a type 2333 ROM used for 
character sets for the video display. This 2333 ROM is rather 
large because it includes a section of straight-through bit- 
mapping for the graphics modes. This way, graphics display 
video can pass through the same circuits as text without 
additional switching circuitry. 

RAM Addressing 

The RAM (programmable) memoiry in the Apple Ite is used both 
tor program and data storage and for the video display. The 
areas in RAM that are used for the display are accessed both by 
the 6502 microprocessor and by the video display circuits. In 
some computers, this dual access results in addressing conflicts 
(cycle stealing) that can cause temporary dropouts in the video 
display- This problem does not occur in the Apple He, thanks to 
the way the microprocessor and the video circuits share the 
memory. 

The memory circuits in the Apple lie take advantage of the two- 
phase system clock described in the section "System Timing to 
interleave the microprocessor memory accesses and the display 
memory accesses so that they never interfere with each other 
The microprocessor reads or writes to RAM only during fiiO. and 
the display circuits read data onfy during -^l, 

Dynamic-RAM Refreshment 

The image on a video display is not permanent; it fades rapidly 
and must be refreshed periodically. To refresh the video dfsplay, 
the Apple lie reads the data in the active display page and sends 
it to the display. To prevent visible flicker in the display, and to 
conform to standard practice for broadcast video, the Apple Me 
refreshes the dispfay sixty times per second 

The dynamic RAM devices used in the Appie Me also need a 
kind of refresh, because the data is stored in the form of electric 
charges which diminish with time and must be replenished every 
so often. The Appie He is designed so that refreshing the display 
also refreshes the dynamic RAMs The next few paragraphs 
explain how this is done. 

The job of refreshing the dynamic RAM devices fs minimized by 
the structure of the devices themselves. The individual data celts 
in each RAM device are arranged in a rectangular array of rows 
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Table 7-9 RAM Address Mtiltiptesirg 



Figure 7-e The 64K HAM Pimuls 
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and columns. When the device is addressed, the part of the 
address that specifies a row is presented first, followed by the 
address of the coJumn. Splitting information into parts that follow 
each other in time is called muttipfexrng . Since only half of the 
address is needed at one time, multiplexing Ifre address reduces 
the number of pins needed for connecting the RAMs. 

Different manufacturers' 64K HAMs have cell arrays of either 128 
rows by 512 columns or 256 rows by 256 columns. Only the row 
portion of the address is used m refreshing the RAMs, 

Now consider how the display is refreshed. As described later In 
this chapter in the section "The Video Counters^ the display 
circuitry generates a sequence of 6,192 memory addresses in 
high-resolution mode; in text and low-resolution modes, this 
sequence is the 1 ,024 display page addresses repeated eight 
times. The disptay address cycles through this sequence 60 
times a second, or once every 17 milliseconds. The way the low- 
order address lines are assigned to the RAMs, the row address 
cycles through all 256 possible values once every half-millisecond 
(see Table 7-9). This more than satisfies the refresh 
requirements of the dynamic RAMs. 
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Dynamic-RAM Timing 



The Apple He's microprocessor clock runs at a moderate speed, 
about 1 023 MHz, but the interleaving of CPU and display cycles 
means that the RAM is being accessed al a 2 MHz rate, or a 
cycle time of jusl under 500 nanoseconds. Data for the CPU is 
strobed by the falling edge of <fjO. and display data is strobed by 
the falling edge of t^l, as shown in Figure 7-9. 

The RAf^ liming looks complicated because the RAM address is 
multiplexed, as described in the previous section. The MMU 
takes care of muitlplexing the address for the CPU cycle, and the 
lOU performs the same function for the display cycle. The 
multiplexed address is sent to the RAM tCs over the lines 
labelled RAO RA7, Along with the other timing signals, the PAL 
generates two signals that control the RAM addressing: Row- 
address Strobe (RAS) and CoJumn-address Strobe (CAS). 



Table 7-10 Dynamic RAM Timing Signal Name Description 

SignaJs 



cM) Clock phase (CPU phase) 

Clock phsse 1 (display phase) 
Rii^S Row-address strobe 

CftS CoJumn-address slrobe 

Q3 Altefnallve column-actdress strobe 

Multiplexed addreg:^ bus 
MD0-MD7 Internal dgiia bus 
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Figure 7-9 RAM Timing Signals 
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The Video Display 

The Apple lie produces a video signal that creates a display on a 
standard video monitor or. if you add an RF modijlator, on a 
black-and-white or cotor television set. The video signal is a 
composEte made up of the data that is being displayed plus the 
horizontal and vertical synchronization signals that the video 
monitor uses to arrange the lines of display data on the screen. 

Apple lie s manufactured (or sale in the U S generate a video signal 
that is compatible with the standards set by the NTSC (National 
Television Standards Committee) Apple lie's manufactured for sale 
in European countnes generate video that is compatible with the 
standard used there, which is call^ PAL (for Phase Alternating 
Lines). This manual describes only the NTSC version of the video 
circuits- 
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The display portion of the video signal is a time-varying voltage 
generated from a stream of data bits, where a one corresponds 
to a voltage that generates a bright dot, and a zero to a dark 
dot. The dispEay bit stream is generated in bursts that correspond 
to the horizontal Hnes of dots on the video screen. The signal 
named undw is low during these bursts. 

During the time intervals between bursts of data, nothing is 
displayed on the screen. During these inten^als, caJled the 
blanking intervafs, the display is bfank and the UNDW signal is 
high. The synchronization signals, called sync for short, are 
produced by making the signal named SVNC low during portions 
of the blanking intervals. The sync pulses are at a voltage 
equivalent to blacker-than-black video and don't show on the 
screen. 



The Video Counters 

The address and timing signals that control the generation of the 
video display are aJI derived from a chain of counters inside the 
EOU Only a few of these counter signals are accessible from 
outside the lOU, but they are all important in understanding the 
operation of the display generation process, particularly the 
display memory addressing described in the next section. 

The horizontaf counter is made up of seven stages; HO, H1 , H2, H3, 
H4, H5, and HPE*. The input to the horizcnlal counter is the 1 MHz 
signal that controls the reading of data being displayed. The 
complete cycle of the horizontal counter consists of 65 states. 
The six bits HO through H5 count normally from to 63, then start 
over at 0. Whenever this happens, HPE' forces another count with 
HO through HS held at zero, thus extending the total count to 65. 

The lOU uses the forty horizontaf count values from 25 through 
64 in generating the low-order part of the display data address, 
as described below in the section "Display Address Mapping' . 
The lOU uses the count values from to 24 to generate the 
horizontal blanking, the horizontal sync pulse, and the color-burst 
gate. 

When the horizontal count gets to 65, it sfgnafs the end of a line 
by triggering the vertical counter. The vertical counter has nine 
stages: VA. VB, VC, VO, V1 , V2, V3, V4, and V5, When the vertical 
count reaches 262, the lOU resets it and starts counting again 
from zero. Only the first 192 scanning lines are actually 
displayed; the JOU uses the vertical counts from 192 to 261 to 
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generate the vertical blanking and sync pulse. Nothing is 
displayed during the vertical blanking interval. (T\)B vertical line 
count is 262 rather than the standard 262.5 because, unlike ■ 
normal television, the Apple lie's video display is not interlaced.) 

Animation displays sometimes have an erratic flicker caused by 
changing the display data at the same time It is being displayed. 
You can avoid this on the Apple lie by reading the vertical- blanking 
signal (vbl) at location *cdi S and only changing display data while 
VBL is low (data value less than 12S). 



Display Memory Addressing 

As described in Chapter 2 in the section ' Addressing Display 
Pages Directly", data bytes are not stored in memory in the 
same sequence in which they appear on the display. You can 
get an idea of the way the display data is stored by using the 
Monitor to set the display to graphics mode, then storing data 
starting at the beginning of the display page at hexadecimal *40Q 
and watching the effect on the display. If you do this, you should 
use the graphics display instead of text to avoid confusion: the 
text display is also used for Monitor input and output. 

If you want your program to display data by storing it directly into 
the display memory, you must first transform the display 
coordinates Into the appropriate memory addresses, as shown in 
Chapter 2. The descriptions that follow will help you understand 
how this address transformation is done and why it is necessary. 
They will not (alas!) eliminate that necessity. 

The address transformation that folds three rows of forty display 
bytes into 128 contiguous memory locations is the same for ali 
display modes, so it is described first. The differences among the 
different display modes are described in the section 'Video 
Display Modes' , below. 

Display Address Mapping 

Consider the simplest display on the Apple lie, the 40-column 
text mode. To address forty columns requires six bits, and to 
address twenty-four rows requires another five bits, for a total of 
eleven address bits. Addressing the display this way would 
involve 2048 (two to the eleventh power) bytes of memory to 
display a mere 960 characters. The 80-co1umn text mode would 
require 4096 bytes to display 1920 characters. The leftover 
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Figure 7-10 Display Address 
Transformation 



chunks of memory that were not displayed could be used for 
storing other data, but not easily, because they would not be 
contiguous. 

Instead of using the horf^ontal and vertical counts to address 
memory directly, the circuitry inside the iOU transforms them inio 
ihe new address signals described below. The transformed 
display address must meet the following criteria: 

• Map the 960 bytes of 40-coJumn text into only 1024 bytes. 

• Scan the low-order address to refresh the dynamic RAMs. 

• Continue to refresh the RAMs during video blanking. 

The requirements for RAfyl refreshing are discussed above, in the 
section "Dynamic-RAM Refreshment' . 

The transformation involves only horizontal counts H3, H^, and hs. 
and vertical counts V3 and V4. Vertical count bits va, vb, and vc 
address the lines making up the characters, and are not Involved 
in the address transformation. The remaining low order count 
bits, Hc, HI , H2, VQ, VI , and V£ are used directly, and are not 
involved in the transformation. 

The IOU performs an addition that reduces the five significant 
count bits to four new signals called SO, 5i , S2, and S3, where S 
stands for sum. Figure 7-10 is a diagram showing the addition in 
binary form, with V3 appearing as the carry in and HS appearing 
as its complement H5\ A constant value of one appears as the 
low-order bit oi the addend. The carry bit generated with the sum 
is not used. 
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If this transformation seems terribly obscure, try it with actual 
values. For example, for the upper-left corner of the display, the 
vertical count is zero and the hohzontal count is 24: HO, H1 , H2, 
and H5 are zeros and hb and H4 are ones. The value of the sum 
is zero, so the memory location for the first character on the 
display is the first location in the display page, as you might 
expect. 
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Horizontal bits ho. hi , and H2 and sum bits so. si , and S£ make up 
the transformed horizontal address [AO through AG in Table 7-11). 
As the horizontal count increases from 24 to 63, the value of the 
sum (53 S2 SI SO) increases from zero to four and the transformed 
address goes from to 39. relative to the beginning of the 
display page. 

The low-order three bits of the vertical row counter are vo, vi , 
and V2. These bits control address bits A7, as, and as shown 
in Table 7-11 , so that rows through 7 start on 128-byte 
boundaries. When the vertical row counter reaches 8, VO, yi , and 
V2 are zero again, and V3 changes to one. If you do the addition 
in Figure 7-10 with h equal to 24 (the horizontal count for the first 
column displayed) and v equal to 8, the sum is 5 and the 
horizontal address is 40; the first character in row 8 is stored in 
the memory location 40 bytes from the beginning of the display 
page. 



Figure 7-11 40-column Text Display 
Memory. Memory tocations marked with 
an asterisK ^'J are reserved for use by 
periphera) I/O linniware; refer to the 
section "Peripheral-card RAM Space", 
\(\ Chapter 6. 
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Figure 7-1 1 shows how groups of three forty-character rows are 
stored in blocks of 120 contiguous bytes starting on 128-byte 
address boundaries. This diagram is another way of descnbing 
the display mapping shown in Figure 2-5 Notice that the three 
rows in each block of 120 bytes are not adjacent on the display 
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T^le 7-1 1 Dtsplay Memory 
Addressirg 

'For Ihese address bits, see text and 
Table 7-12. 



Memory Display 
Address Bit Address Bit 



AO 


HO 




Hi 


A? 


H2 


A3 


SO 




51 




S2 




S3 


A7 


vo 


AS 


VI 




V2 


A1 




A11 




f^l £ 




A1 3 




A1 4 




A1B 





Table 7-1 1 shows how the signals from the video counters are 
assigned to the address lines, ho. hi . and »2 are horizontal-count 
bits, and vo. vi , and V2 are vertical-count bits. SO, 5i , S£ and S3 
are the tolded address bits described above. Address bits 
marked with asterisks (* ) are different for different modes; see 
Table 7-12 and the next three sections. 
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Table 7-12 Memory Address Bi^s for 
Display Modes 



Address Bit 



Display Mod?: 
Text and Lo-Res Hl-Rcs 



A1 I 

A1 2 
A1 3 
A1 4 



eoviD - P&2 

SOVID ■ PG2 




VE 

vc 

BOVID + PGZ' 

eoviD' -PGa 



158 



Video Display Modes 

The different display modes all use the address-mapping scheme 
described in the previous section, but they use ditferent-si2ed 
memory areas in different locations. The next three sections 
describe the addressing schemes and the methods of generating 
the actual video signals for the different display modes. 

Text Disptsys 

The text and iow-resolution graphics pages begin at memory 
locations *400 and *aoo Table 7-12 shows how the dispiay-mode 
signals control the address bits to produce these addresses. 
Address bits A10 and A11 are controlled by PG2 and 80VID, which 
are set by the display-page and 90-column-video soft switches. 
Address bits Ai 3. and Ai -4 are set to zero. Notice that 8CVID 
active inhibits PG2: there is only one display page in 80-co3umn 
mode. 

The low-order six bits of each data byte reach the character 
generator directly, via the video data taus vido-vidb The two high- 
order bits are modified by the lOU to select between the primary 
and alternate character sets and are sent to the character 
generator on lines Rfl9 and RAi o. 

The data for each row of characters are read eight times, once 
for each of the eight lines of riots making up the row of 
characters. The data bits are sent to the character generator 
along with Vfl, VB, and vc, the low-order bits from the vertical 
counter. For each character being displayed, the character 
generator puts out one of eight stored bit patterns selected by 
the three-bit number made up of Vf^, VB, and VC. 
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Figure 7-lZ Video Timing SignaJs 



The bit patterns from the character generator are loaded into the 
74166 parallel-to-serial shift register and output as a serial bit 
stream that goes to the video output circuit. The shift register is 
controlled by signals named ldPS' (for load parallel-to-serial 
shifter) and v I D7M (for video 7 Mhz>. In 40-column mode. LDPS ' 
strobes the output of the character ger>erator into tlie shift 
register once each micmsecond, and VID7M shifts the bits out at 7 
MHz. 

The addressing for the 80-column display is exactly the same as 
for the 40-column display: the 40 columns of display memory on 
the SO-column card are addressed in parallel with the 40 columns 
in main memory. The data from these two memories reach the 
video data bus (lines Vl DO- V1D7) via separate 74LS374 three-state 
buffers. These buffers are loaded simultaneously, but their 
outputs are sent to the character generator alternately by (f>o and 

\n 80-column mode, LDPS' loads data from the character 
generator into the shift register twice during each microsecond, 
once during (f«o and once during </)1, and viD7ri runs at 14 MHz to 
shift the data bits out twice as fast. 
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Low-Resolution Dispi&y 



In the graphics modes, VA and VB are not used by the character 
generator, so the lOU uses lines SEGA and SE&B to transmit ho and 
HIRES', as shown in Table 7-13. 



Table 7-13 Character generator 
Conirol Signals 



DfSplsy mode 

Text 

Graphics 



SEGB 



SCGC 



VA 

HO 



VB 

HIRES* 



VC 

vc 



The low-resolution graphics display uses vc to divide the eight 
display lines corresponding to a row of clnaracters into two 
groups of four lines each. Each row of data bytes is addressed 
eight times, the same as in text mode, but each byte is 
interpreted as two nybbles. Each nybble selects one of sixteen 
colors. During the upper four of the eiglit display fines, vc is low 
and the low-order nybble determines \he color. During the tower 
four display lines, vc is tiigh and tlie high-order nybble 
determines the color. 

The bit patterns that produce the low- re solution colors are read 
from the character-generator ROM in the same way the bit 
patterns for characters are produced in text mode. The 74166 
parallel-to-serial shift register converts the bit patterns to a senal 
bit stream for the video circuits. 

The video signal generated by the Apple Me includes a short 
burst of 3.58 MHz Signal that is used by an NTSC color monitor 
or color TV set to generate a reference 3. 58 MHz color signal. 
The Apple lie s video signal produces color by interacting with 
this 3.58 MHz signal inside the monitor or TV set. Different bit 
patterns produce different colors by changing the duty cycles and 
delays of the bit stream relative to the 3 58 MHz color signal To 
produce the small delays required for so many different colors, 
the shift register runs at 14 MHz and shifts out 14 bits during 
each cycle of the 1-MHz data clock. To generate a stream of 
fourteen bits from each eight-bit pattern read from the ROM, the 
output of the shift register is connected back to the register's 
serial input to repeat the same eight bits; the last two bits are 
ignored the second time around. 



160 



Hardware Implementation 



Each bit pattern js output for the same amount of time as a 
character; 1.02 rnicroseconds. Because that is exactly enough 
time for three and a half cycles of the 3,58 MHz color signal, the 
phase relationship between the bit patterns and the signal 
changes by a haif cycle for each successive pattern. To 
compensate for this, the character generator puts out one of two 
different bit patterns for each nybble. depending on the state of 
HO, the iow-order bit of the horizontal counter. 

High-Resolution Display 

The high-resolution graphics pages begin at memory locations 
*2000 and t^OOQ (decimai Bi 92 and 1 S3B4). These page addresses 
are selected by address bfts Ai 3 and A1 4. In high-resolution mode, 
these address bits are controlled by PG£ and 80VID, the signals 
controlled by the display-page (PAGE2) and flO-column -video 
(BOCDL) soft switches. As in text mode, gov ID Inhibits addressing of 
the second page because there is only one page of 80-column 
text available for mixed mode 

In high-resolution graphics mode, the display data are still stored 
in blocks like the one shown in Figure 7-11, but there are eight 
of these blocks. As Tabie 7-1 1 and Table 7-12 show, vertical 
counts VA, VB, and vc are used for address bits At 0, Ai i , and Ai £, 
which address eight blocks of 1024 bytes each. Remember that 
in the display Vfl. vb, and vc count adjacent horizontal lines in 
groups of eight. This addressing scheme maps each of those 
lines into a different 1024-byte block. It might help to think of ft 
as a kind of eight-way multiplexer: it's as if eight text displays 
were combined to produce a single high-resolution display, with 
each text display providing one iine of dots in turn, instead of a 
row of characters, 

The high resolution bit patterns are produced by the character- 
generator ROM. In this mode, the bit pattems simpfy reproduce 
the eight bits of display data. The low-order six bits of data reach 
the ROM via the video data bus vido-vids. The lOU sends the 
other two data bits to the ROM via RA9 and RAi 

The high resolution colors described in Chapter 2 are produced 
by the interaction between the video signal the bit patterns 
generate and the 3,58 rylHz color signal generated Inside the 
monitor or TV set. The high-resolution bit patterns are always 
shifted out at 7 MHz, so each dot corresponds to a halt-cycle of 
the 3,58 MHz color signal. Any part of the video signal that 
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produces a single white dot between two black dots, or vice- 
versa, is effectively a short burst of 3. 58 MHi and is tfierefore 
displayed as color. In other words, a bit pattern consisting of 
alternating ones and zeros gets displayed as a line of color. The 
high- resolution graphics subroutines produce the appropriate bit 
patterns by masking the data bits with alternating ones and 
zeros. 

To produce different colors, the bit patterns must have different 
phase relationships to the 3.58 MHz color signai. If alternating 
ones and zeros produce a certain color, say green, then 
reversing the pattern to zeros and ones will produce the 
complementary color, purple. As in the low-resolution mode, each 
bit pattern corresponds to three and a half cydes of the color 
signal ^ so the phase relationship between the data bits and the 
color signal changes by a half cycle for each successive byte of 
data. Here, however, the bit patterns produced by the hardware 
are the same for adjacent bytes; the color compensation is 
performed by the high-resolution software, which uses different 
color masks for data being displayed in even and odd columns, 

To produce other colors, bit patterns must have other timing 
relationships to the 3.58 MHz color signal. In high-resotulion 
motie, the Apple lie produces two more colors by delaying the 
output of the shift register by half a dot (70 ns), depending on 
the high-order bit of the data byte being displayed, (The high- 
order bit doesn't actually get displayed as a dot, because at 
7 MHz there is only time to shift out seven of the eight bits.) 

As each byte of data is sent from the character generator to the 
shift register, high-order data bit D7 is aiso sent to the PAL If D7 
is off, the PAL transmits shift-register liming signals LDPS* and 
V1D7M normally. If D7 is on, the PAL delays LDPS' and vid7M by 70 
nanoseconds, the time corresponding to half a dot. The bit 
pattern that formerly produced green now produces orange; the 
pattern for purple now produces blue. 

A note about liming: For 8(H;olumn text, the $tiift register is clocked 
at twice normal speed When aO-column text is used with graphics 
in mixed mode, the PAL controls shift-register timing signals lDPS' 
and viD7n so that the graptiics portion ol the display works correctly 
6ven when the text window is in SO-column mode. 



Hardware Implementation 



Video Output Signals 

The stream of video data generated by the display circuits 
described above goes to a linear summing circuit built around 
transistor Ql where It is mixed with the sync signals and the 
color burst. Resistors R3. R5, R7, RIO. R13, and R15 adjust the 
signals io the proper amplitudes, and a tank circuit (L3 and C32) 
resonant at 3.58 MHz conditions the color burst. 

The resulting video signal is an NTSC compatible composite- 
video signal that can be displayed on a standard video monstor. 
The signal is similar to the EIA (Electronic Industries Association) 
standard positive composite video (see Table 7-14). This signal is 
avaifable in two places in the Appie lie: 

• At the phono jack on the back of the Apple lie. The sleeve of 
this jack fs connected to ground and the tip is connected to 
the video output through a resistor network that attenuates it 
to about 1 volt and matches its impedance to 75 ohms. 

• At the internal video connector on the Apple lie circuit board 
near the RCA jack, J13 in Figure 7-14c. It Is made up of four 
Molex-type pins, 0.25 inches tall on 0.10 inch centers. This 
connector can'ies the video signal, ground, and two power 
supplies, as shown in Table 7-14. 



Tal>le7'14 Internal Video Connector Pin Number Namt Description 

Signals 

1 GROUND Syslem common ground 

2 VIDEO NTSC-coitipatible posrtive composite video. While 

level is about 2.Q uolt^, black level is about 0.75 
volts, and sync level is O.Q votls. This Dutpul is rial 
protected againat short circuits. 

a - S V - 5 volt power su pply 

4 + 1 2V +12 woll power supply 
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BuUt'in no Circuits 

The use ot the Apple Me s built-in I/O features is described in 
Chapter 2 This section describes the hardware implementation of 
all ot those features except the video display described in the 
previous sections. The lOU (Input/Output Unit) generates the 
output signals for the speaker^ the cassette interface, and the 
annunciators dfrectly. The other I/O features are handled by 
smaller IGs, as described below. 

The addresses of the buiit-in I/O features are described in 
Chapter 2 and listed in Table 2-2, Table 2-11, and Table 2-12. All 
of the built-in I/O features except the displays use memory 
locations between scooo and »CQ70 (decimal ^91 52 and 49264), 
The I/O address decoding is performed by three ICs: a 74LS138, 
a 74LS1 54. and a 74LS251 . 

The 74LS138 decodes address lines AG, A9, A1 0. and Al 1 to select 
address pages on 256-byte boundaries starting at *C0O0 (decimal 
49152) When it detects addresses between ICOOO and *coFF, It 
enables the lOU and the 74LS154. The 74LS154 in turn decodes 
address lines A4, A5, A6, and p\7 to setect 16 byte address areas 
between «C0Q0 and *coFF. Addresses between *coso and *C0GF 
enable the 74LS251 that multiplexes the hand control switches 
and paddles; addresses between *C070 and tCQ7F reset the 
NE55S quadruple timer that interfaces to the hand controls, as 
described below in the section Game I/O Signals' . 



The Keyboard 

The Apple lie's keyboard is a matrix of keyswitches connected to 
an AY-3600-type keyboard decoder via a ribbon cable and a 26- 
pin connector. The AY-3600 scans the array of keys over and 
over to detect any keys pressed. The scanning rate is set by the 
external resistor-capacitor network made up of C70 and R32, The 
debounce time is also set externally, by C71. 

The AY-3G00's o utputs inclu d e five bits of key code plus 
separate lines for rcaNTRaL | , | ' SHIFT | , any-key-down > and keyboard 
strobe, The any-key-down and keyboard -strobe lines are 
connected to the lOU, which addr esse s them as sof t switches. 
The key-code lines, along withl caNTRQLj and [jhTfT] , are inputs 
to a separate £316 ROM. The ROM translates them to the 
character codes that are enabied onto the data bus by signals 
namedKBD' and enkbd' . The kbD' signal is enabled by the MMU 
whenever a program reads location *CO0Q, as described in 
Chapter 2. 
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Table 7-1S Keyboard Connector 



Pin Numb*r 

1,2,4, 

6, a, 10, 

23, 25, 
12,22 



5, 7, 9, 15 
1 

13 

14. 16, 
20. 21. 19. 
26. 17 

24 



Name 



DescripUon 



-t-5 
n. c, 

LCISTL" 
GND 

LSMFT' 



Y-direction key-matrix connections 
+5 volt supply 



Line Irom CO NTROL] kBy 
System common ground 

X-direction key-matrix connectkins 



Line from J SHIFT | key 



Connecting a Keypad 

There is a smalfer connector wired in parallel with the keyboard 
connector. You can connect a ten-key numeric pad to the 
Apple lie via this connector. 



Table 7-lfi Keypad Connector Signals Pin Number Name Description 



r 2, 5, 

3, 4, 6 VD-VB Y-directiori key-matrix connections 

7 n. c. 

9, 11. 

10. 8 X^-X7 X-direcllon key-matnx conneclions 
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Table 7-t7 Speaker Conneclor 
Signals 



The Speaker 

The Apple lie's built-in loudspeaker (s controlled by a single bit of 
output from the lOU {Input Output Unit) The signal from the lOU 
is AC coupled to Q5, an MPSA13 Darlington transistor amplifier. 
The speaker connector is a Molex KK100 connector. J18 in 
Figure 7 14b. with two square pins 0,25 inches tall and on 0-10- 
inch centers, 

A tight-emitting diode is connected in parallel across the speaker 
pins such that, when the speaker is not connected, the diode 
glows whenever the speaker signal is on. This diode is used as 
a diagnostic indicator during assembly and testing oi the 
Apple tie. 
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Cassette ilO 

The two miniature phone jacks on the back of the Apple Me are 
used to connect an audio cassette recorder for saving programs. 
The output signal to the cassette recorder comes from a pin on 
the lOU via resistor network R6 and R9. which attenuates the 
signal to a level appropriate for the recorder s microphone input. 
Input from the recorder is amplified and conditioned by a type 
74 1 operational amplifier and sent to one of the inputs of the — | 

74LS251 input multiplexer. 

The signal specifications for cassette liO are: 

Input; 1 volt [nominal) from recorder Earphone or Monitor 

output. Input impedance Is 12K ohms. ^ 

Output: 25 millivolts to recorder Microphone input. Output ^ 
impedance is 100 ohms, — 



Pin Number 


Hantfl 


DMcription 


1 


SPKE 


Speaker signal. TWs line will deliver about 0,5 




watts into an S-ohm speaker. 


Z 


+ S 


+5V power supply. Noie that the speaker Is not 






connected to system ground- 
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Game liO Signals 



Several I/O signals that are individually controlled via soft 
switches are collectively referred to as the game signals. Even 
though they are normally used for hand controls, these signals 
can be used for other simple I/O applications. There are five 
output signals: the lour annunctators. numbered f^o through A3^ 
and one strobe output. There are three one-bit inputs, called 
switches and numbered swo through swe, and four analog inputs, 
called paddles and numbered pdlo through PDL3. 

The annunciator outputs are driven directly by the lOU (Input 
Output Unit). These outputs can drive one TTL {transitor-transitor 
logic) load each; for heavier loads, you must use a transfStor or a 
TTL buffer on these outputs. These signals are only available on 
the 16-pin internal connector (see Table 7-18). 

The strobe output Is a pulse transmitted any time a program 
reads or writes to location *C040. The strobe pin is connected to 
one output of the 74LS1S4 address decoder This TTL signal is 
normally high; it goes low dunng <j)0 of the instruclion cycle that 
addresses location *ci)flO. This signal is only available on the 16- 
pin internal connector (see Table 7-18). 

The game inputs are multiplexed along with the cassette input 
signal by a 74LS251 eight-input multiplexer enabled by the coex' 
signal from the 74LS1S4 I/O address decoder. Depending on the 
low-order address, the appropriate game input is connected to bit 
7 of the data bus. 

The switch inputs are standard low-power Shottky TTL inputs. To 
use them, connect each one to 220 ohm pull-up resistors 
connected to the +5-vo!t supply and through single-pole, 
momentary-contact pushbutton switches to ground. 

The hand-control inputs are connected to the timing inputs of an 
IMESSe quadruple SSS type analog timer. Addressing •C07x sends 
a signal from the 74LS154 that resets all four timers and causes 
thetr outputs to go to one (high). A variable resistance of up to 
150K ohms connected between one of these inputs and the +5V 
supply controls the charging time of one of four 0.022-microfarad 
capacitors. When the voltage on the capacitor passes a certain 
threshold, the output of the NE558 changes back to zero (low). 
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Tab(e 7-1fi Game I/O Connector 
Signals 



Programs can determine the setting of a variable resistor by 
resetting the timers and tlien counttng time until the selected 
timer input changes from high to low. The resulting count is 
proportional to the resistance. 

The game I/O signals are alE available on a 16-pin DfP socket 
labelled GAME I/O on the main circuit board inside the case. 
The switches and the paddies are also available on a D-type 
miniature connector on the back of the Appie Me: see J8 and J15 
in Figure 7-1 4d. 



Internal' 
Connector 
Pin Number 



Back-panel- 
Connector 
Pin Niimber 



Signet 
Name 



Description 



+ EV 



+ 5 power supply. Total 
curreni drain from this pin 
must rot exceed 100mA, 



2.3, 4 



7. 1.6 



6. 10, 7, 11 



5, 8. 4. 9 



15, 14, 13, 12 



9, 16 



PBO ^ PB2 Swilcti inputs, Thes© are 
Standard 74LS inputs. 

STROBE' Strobe oulpul- Ttiis line goes 
low during ot a read or 
write irstruciion to locatton 
»C04D. 

PDLO - PDL 3 Hand control inputs. Eacti of 
these should be connected 
to a l50K-ohm variable 
resistor connected to 

GHD System ground. 

flM0-flH3 Annunciators. These are 

standard 74LS TTL outputs 
and must be buffered to 
drive other than TTL inputs, 

n. c. Nothing is connected to 

these pins. 
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Expanding the Apple lie 

The main circuit board of the Apple He has eight empty card 
connectors or slots on it. These slots make it possible to add 
features to the Apple lie by plugging in peripheral cards with 
addilional hardware. Chapter 6 descnbes the standards for 
programming peripherai cards for the Apple lie. This section 
describes the hardware that supports them, including all of the 
signals available on the expansion slots. 

The Expansion S/ofs 

The seven connectors iined up across the back part of the 
Apple lie's main circuit board are the expansion slots, afso called 
peripheral slots or simply slots, numbered from 1 to 7. They are 
50-pin PC-card edge connectors with pins on OJO-inch centers. 
A PC card plugged into one of these connectors has access to 
all of the signals necessary to perform input and output and to 
execute programs in RAM or ROM on the card. These signals 
are described briefly in Tables 7-19a, 7-19b, and 7-f9c. The 
following paragraphs describe the signals in general and mention 
a few points that are often overlooked. For further detafis, refer 
to the schematic dtagram in Figures 7-14a, 7-14b, 7-140, and 7-14d. 



The Peripher&i Address Bus 

The 6502's address bus is buffered by two 74LS244 octal three- 
state buffers. These buffers, along with a butter in the 6502 s 
R/W line, are enabled by a signal derived from the DMA' daisy- 
chain on the expansion slots. Pulling the peripheral line DMA' low 
disables the address and R/ui' buffers so that penpherai Df^A 
circuitry can control the address bus The DMA address and 
R/W signals supplied by a accessory card must be stable all 
during tf>o of the instruction cycle, as shown in Figure 7-13. 

Another signal that can be used to disable normal operation of 
the Apple lie is inh'. Pulling inh' low disables all of the memory 
in the Apple lie except the part in the I/O space from fcooo to 
SCFFF. A peripheral card that uses either INH' or DMA' must 
observe proper timing; in order to disa&le RAM and ROM cleanly, 
the disabling signat must be stable all during 4io of the instruction 
cycle (refer to the timing diagram in Figure 7-13). 

The peripheral devices should use I/D SELECT' and 
DEVICE SELECT' as enables. Most peripheral ICs require their 
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Each daisy chain works ifke this: the output from each connector 
goes to the input of the next higher numbered one> For these 
signals to be useful for cards in lower numbered connectors, all 
of the higher numbered conriectors must have cards in them, and 
all of those cards must connect DMA in to DMA out and INT IN to INT 
OUT, Whenever an accessory card uses pin DMft' , it must do so 
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enable signals to be present tor a certain length of time before 
data (s strobed into or out of the device. Remember that I/O 
SELECT' and device SELECT' are only asserted during ffro high. 

The Peripheral Data Bus | 

The Apple lie has two versions of the 6502 data bus: an internal ^ 
bus, MDO MD7, connected directly to the 6502; and an external bus, J 
D0-D7, driven by a 74LS245 octal bidirectional bus buffer. The r^^m 
6502 is fabricated with MOS circuitry, so it can drive capacitive 
loads of up to about 130 pF. If peripheral cards are Installed in 
all seven slots, the ioading on the data bus can be as high as 
500 pF. so the 74LS245 drives the data bus for the peripheral 
cards. The same argument applies if you use MOS devices on 
peripheral cards: they don't have enough drive for the fuJIy- 
loaded bus, so you should add buffers. 



Loading and Driving Rules 

Tables 7 19a. 7 1 9b. and 7-1 9c show the drive requirements and 
loading limits for each pin on the expansion slots. The address 
bus, the data bus. and the R/W line should be driven by three- 
state buffers Remember that there is considerable distributed 
capacitance on these busses and that you should plan on 
tolerating the added ioad of up to six additional peripheral cards, 
MOS devices such as PlAs and ACIAs cannot switch such heavy 
capacltive loads. Connecting such devices directly to the bus will 
lead to possible timing and level errors. 

interrupt and DMA Daisy Chains 

The interrupt requests {IRa' and nmi ') and the direct-memory — ^ 

access (di^p') signal are available at all seven expansion slots. A J 
peripheral card requests an interrupt or a Drift transfer by pufling 
the appropriate output line low (active). If two peripheral cards 
request an interrupt or a DKA transfer at the same time, they will 
contend for the data and address busses. To prevent this, two 
pairs of pins on each connector are wired as a priority daisy 
chain. The daisy-chain pins lor interrupts are INT IN and IHT OUT, 
and the pins for DhA are Dm in and dmp out, as shown for J1-J7 in 
Figure 7-1 4d. 
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only if its DMft IN line is active, and it must disable its DMA OUT line 
wiiile it is using DMA ' . The I NT [ H and I NT DUT lines must be used 
the same way: enable the card's interrupt circuits with ml in, and 
disable INT auT whenever IRQ' or Nni ' is being used. 
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ADDRESS - — ^ 
llNH'. DMA- 



PERIPHERAL SELECT 
I/O SELECT' J 
DEVICE SELECTS 
i/O STROBE \ 
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Table 7-19a Eitpansinri Slot Signals Pin Number Name Description 

•Loadirtg limits are far each card 



1 I/O SELECT Mormally high: goea low during tfrO when the 6502 

addresses focalior tCnisX, where n islhe 
connector number. This line car drive 10 LS TTL 
loads, ' 

2-17 flO-ftI 5 Thiee-state address bus, The aOdress becomes 

valid djring r>i ard remains valid dunng f^D. Each 
address i]ne can drive 5 LS TTL loads- 

13 R/(j' Three-stale read/write line- Valid at the same time 

as the address bus; high during a read cycle, low 
during a write cycle It car> drive 2 LS TTL loads,* 

ig SYNC Composile horizontal and verticai sync, on 

expansion slot 7 ONLY. This line can drive 2 LS 
TTL loads," 

20 ] y D Normaiiy high; goes low during 4^ when the 6502 
STROBE' addresses a iacation between tC800 and 

1 CfFF, ThFS Jine can drive 4 LS TTL loads. 

21 RDY lopui 10 the 6502. Pulling this line lovy during fhl 

halts the 6502 with the address bus holding ihe 
address ol the iocation currently being fetched 
This iine has a 3300 ohm pullup resistor to +5V. 

22 DWft' InpLii to ttie address bus buffers. Pulling this line 

low during ^i disconnects the 6502 from Ihe 
address bus. This line has a 330Q ohm pullup 
restslor to +5V 

23 INT OUT Interrupt prioritv daisy-chain output Usually 

connected to pin 28 (INT IM). 

<Nole: on slot 7 O^LY, this pin car be connected 

to the graphics-mode signal GR; see text for 

details.) 

24 DMA DUT DMA priority daisy-chain output, Usually 

connected to pin 22 (DMA I N). 

25 ^-£y +5-voll. power supply. A total of 5O0miA Is 

available for ait accessory cards. 

26 QHD System common ground- 
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Table 7-1 9b Expansion SIdI Signals, Pin Number Namfi Description 

continued 

^Loading limits are for each cafd. 27 DPlfl IN DMA priorify daisy-chair input. Usjally connected 

lo pin 24 (DMA QUT). 

28 INT IH mterrupl priority daisy-chain input. Usually 

connected to pin 23 ( 1 NT DUT }. 

29 Nni' N on maskable inlefrupt to 6502 Pjlling inis line 

low stais an mlerrupt cycle with the 

in lerrupt- handling rouline at location i03FB. This 

line Jias a 3300 Dhm puiiup resistor to + 5V. 

30 IRQ' Inlernjpt request lo 6502. Pjlling this Iffie low 

starts an inlerrupt cycle only if the 
Interrupt-disable (I) flag »n the 6502 is not set_ 
Uses the internjpt-Jiandhng rouline at location 
» D3FE . This tine has a 3300 ohm pullup resistor 
to +5V. 

31 liES ' Pulling this line low initiates a rese! routine, as 

flescfibed in Chapter 4. 

32 INH' Pulling this line low during i^l inhibits (disables) 

the memory on the main circuit board- This line 
hss a 330Q ohm pullup resistor to +5V 

33 -12V -12 volt power supply. A total of 200mA is 

availabte lor all accessory cards. 

34 -5V -5 vDit [ffiwer supply. A lotal of 200mA is 

available lor all accessory cards, 

35 3 , 5®n 3.58 MHz color reference signal, on slot 7 only. 

This line can drive 2 LS TTL loads,* 

36 7M System 7 MHz clock. This tine can drive 2 LS TTL 

loads ■ 

37 Q3 System 2. MHz aBymmBlrlcal clock. Ttiis line can 

drive 2 LS TTL loads." 

38 (fri 6502 phase 1 clock. This line can drive 2 LS TTL 

loads. ■ 
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Table 7-19c Expansion S?ol Signals, 
continued 

^Loading limits am (or each card- 



Pin Number 



Name 



Descilptidrt 



39 



40 



41 



42^9 



SO 



^PSVNC 



The 6502 signals an operand fetch by driving Ihis 
line high during Ibe frrst read cycle of each 
instruction. 



6502 phase clock. This I 
toads, ' 



ine can drive a LS TTL 



device: 

SELECT' 



DO -D7 



Normally high; goes low during <AQ when the 6502 
addresses localion *COti)(, where n isthe 
connector number plus 8. Tliis line can drive 10 
LS TTL loads." 

Three-state buffered bi -directional data bus. Data 
becomes valid during fjiO high and remains valid 
until goes low. Each data line can drive one LS 
TTL load." 

+ 12 voll power supply. A total ot 250mA is 
available for all accessory cards. 



Video Signals on Slot 7 

The video signals are available only on the auxiliary slot and not 
on tlie numbered expansion slots, except for slot 7. The video 
signals avatlable on expansion slot 7 are SVNC ' , the composite 
horizontal and video sync signal, on pin 19, and 3.5QM, the color 
reference signal, on pin 35. Early production Apple lies, identified 
by a circuit board part number ending in -A, do not have this 
feature. 

The signal that enables the graphics nnod^s, named gr, is not 
normafly available on the numbered expansion slots. Yoti can make 
it auailabfe on pin 23 of slot 7 by completing the circuit a( location 
X7 on the main circuit board. Remember lo turn off the power 
before changing anything insfde the Apple Me. Also remember that 
changes such as this are at your own risk and rnay void the 
wan-anly. 
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The Auxiliary Siot 

The large connector at the left side of the Apple lie's main circuit 
board is the auxiliary slot. It is a 60-pin PC-card edge connector 
with pins on 0.10-inch centers. A PC card plugged rnto this 
connector has access to ali of the signals used in producing 
the video display. These signals are described briefly in Tables 



Hardware Implementation 



J 

i 



7-20a, 7-20b. and 7'20c. For further details, refer to thie 
schematfc diagram in Figures 7- 14a, 7-1 4b. 7-1 4c, and 7-1 4d, 

Many of ttie interna! signals that are not available on the 
expansion slots are on the auxiliary sbt. By using both kinds of 
connectors, manufacturing and repair personnel can gain access 
to most of the signals needed for diagnosing problems in the 
Apple Il8^ 

80-coiumn Display Sigrtat^ 

The additional memory needed for producing an 80-column text 
display is on the SO-coiumn text card, along with the buffers that 
transfer the data to the video data bus, as described above in 
the s&ction Text Displays The signals that control the 80- 
column text data include the system clocks (Jio and t£fl , the 
multiplexed RAM address RA0-RA7. the RAM address-strobe 
signals pras' and pcas\ and the auxiliary-RAM enable signals, 
ENSQ' and R/W80. The EN80' enable signal is controlled by the 
80 STORE soft switch described in Chapter 4. Data is sent to the 
auxiliary memory via the internal data bus MD0-riD7; the data is 
transferred to the video generator via the video data bus VIDO^ 
VID7. 
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Table 7-2aa Auxiliary Slot Signals Pin Numlwr Name Description 



6 

7 



3 . 5SM 3.58 MHz video color feteirence signal. This line 

car drive two LS TTL toads. 

VID7MI Clocks the vyd&o dots out of Ihe 74166 

parallel-lo-serEal shift register. This line can drive 
two LS TTL loads- 

SVKC Video honzontal and vertical sync signal. This line 

can drive rwo LS TTL loads- 

PRAS' Multiplexed RAM row-address sirobe. This line 

can drive two LS TTL loads^ 

VC Third low-order vertical-counter bit. This line can 

dnve two LS TTL loads. 

C 7 X ■ Hand-control reset signal . This line can df ive two 

LS TTL loads. 

UHDM' Video non-biank window. This line can drive two 

LS TTL loads. 

SEGA First (ow-order vortical counter bil. This line can 

drive two LS TTL bads. 



51. 10, 49. 
48. 13, 14, 
46. 9 



11, 12 



Multiplexed RAM-ad-dTess bus. This line can drive 
two LS TTL loads. 

RaMENi. Enable signals for the ROMs or the main circuit 
HUMENS board. 



IS 



R/W Read/write signal from 6502 This line can drive 

two LS TTL loads. 



44, 43. 40, 
39, 21,30, 
17, 16 



MDO -MP7 Internal (unbuffered) data bjs. This line can drive 
tvKD LS TTL loads, 



17t 
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Tabfe 7-:?Qb Auxiliary SJot Signals. Pin hJuinber Name Description 

cofilinued 



46, 42, 41. 
3S. 22, ^9. 

16. 15 VID0-VID7 Video databus This Ihtee-stale bus carries video 

data 10 ihe character generator. 

23 AO 6502 Clock ]3has6 0, TDis line can drive two LS 

TTL ioads. 



24 



25 



26 



27 



2e 



29 



30 

31 

33 
34 



CLRGAT ' Color-burst gating signai. This iine can drive Iwo 
LS TTL bads, 

80WI.D' Enables SO-column display timing. This line can 
drive two LS TTL loads. 

EMSO Enablo For auxiliary RAM. This line can drive two 

LS TTL loads, 

ALTW 1 D ■ Alternative video output to the video summing 
amplifier. 

SERQUT' Video serial output from 74166 paralleMo-serial 
shift rogister. 

ENVID' NormaKy low; driving this line high disables the 

characlor generator such that the video dots from 
the shift register are all high (white), and 
alternative video can be sent out via flLTVtD'. 
This line hasa IDOQ ohm pulldown resistor to 
ground- 

+S +5 volt power supply. 

GND System common ground. 

1 4n 1 MHz m aster c lock signal. This II ne can drive 

two LS TTL toads. 

PCA5 Multiplexed column-address strobe. This line can 

drive two LS TTL loads. 

LDPB ' Strobe lo video parallel -to-serjaJ shift register. This 

signal goes low to load the contents of the video 
data bus into the shift register. This line can drive 
two LS TTL loads. 
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Table ?-20c Ajxiliary Slot Signals. Pin Number Name Description 

continued " 



35 WSO Read/wrile signal lor RAM on IHe 80-coluTnn lent 

eafd. TtiiB line can drive two LS TTL loads. 

36 (&1 6502 clQck phase t . This line can drive two LS 

TTL loads, 

37 CASEN ' Column-address enable. This signal is disabled 

(held high) d jTing accesses to memory on the 
auxiliary card, Ttiis line can drive two LS TTL 
loads. 

47 HD Low ordef horizontal byte countar- This line car 

drive two LS TTL loads. 

50 flN3 OutpjT Of annunciator number 3. This line can 

drive two LS TTL loads. 

52 fi/u 6502 read/write signal. Ttiis line can dfivo two LS 

TTL loads. 

53 Q3 2 MHz asymmetrical clock. This line can drive two 

LS TTL loads. 

54 SEGB Second low-order vertical-counter bit. This line 

can drive two LS TTL loads. 

55 EIHFlRIO Normally high; pulling this line low 

disables RDMi and ROn£ on the main circui 
board. This line has a 3300-ohm pullup resistor to 
+5V. 

56.57 RfltO' Characler-generalor control signals from the lOU, 

This line can drive Iwo LS TTL loads. 

53 {jR Graphics-mode enable signal. This lina can drive 

two LS TTL loads. 

59 7M 7 f^Hz timing signal. This line can drive two LS 

TTL loads. 

60 ENThlG ■ NormaMy low: pulling this line high disables the 

master timing from the PAL. This line has a 10QO 
Ohm pulldovi'n resistor 1o gfound. 
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Appendix A 

The 6502 Instruction Set 



The Following Notation Applies to This 
Summary: 



A 

X • 
M 
C 
P 

s 



V 

PC 

PCH 

PCi 

□PER 



AcCumumilOf 
lnd».r HegislBri 
Memory 
Borrow 

processor Sl*1ui R&Bialer 
No Ch»ng* 

Aoa 

Lagtcn\ AND 

TtHnsTer Tn StAfii 
Transfer To 
Trtnjfef To 
LogiCKl OR 
Progiram CaLnnt#r 
Program Courier HiflU 
Prc-gfsm Counter Ld-a 



FIGURE 1 A5L-5MIFT LEFT OmE B^T OPERATION 



c 




7 


6 


S ^ 


3 £ 
























FPGURE a ROTATE ONE BIT LEFT (MEMORv 
on ACCUMULATOR) 



M on A 



i 4 



FIGURE a ROTATE ONE BIT RIGHT {MEMORV 
OR ACGUWLrUTOfl) 



7 


6 


5 


A 


3 


Z 


1 


□ 



NOTE 1 BIT - TEST BITS 

&il S inQ T are Iranslerred Xa Iha St41iui» rffgnter II IhQ 
fflSuM of A A )^ 1$ Z^"> tlian ^=1 , □t>iBrvi'^KC Z^O 
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6502 Microprocessor fnsiructions 



ADC Affl MemoTv id ftc c um u-fal d' wilh 

AND "AND Mcrfiiory «rin Acc^muialar 

ASL SMi-H Lett Ori« Bif iW^rtieiry Of 

aCC Br*rich Of* C»'f)t Cl*af 

aCS Branth of- Ci'fy S-fl 

BEO Branch af Res u 11 Ztre 

BIT I'^St P'lls II Memory wi^h 

BMI Srancn on RcjuH Minus 

BtlE flrancH RtiwH no! ZttO 

BPL Branc*! fln Rb-suII Pius- 

BVC Branch u/i Ov*riiB* Cl»ir 

BVS Branch on Ovflrlloyi &*( 

CLC CiDiir Carry Flag 

■CLD Cltar D*tii*i*l Mpde 

CLI Clear InlerridC?! DifAM« Bit 

CLV Cl^^r OverfliDw Flag. 

CMP COi^Da'f Memory and AccumulaLar 

CPU Compare Me^^^5ry jno ina«« » 

CPV CcjTipare Memory and Irediii Y 

DEC Deciemienl Mtnnory by Qr>t 

DEX Oe'(.ieni4n>; Indei^ X. by Qne 

DEV DodErrshi Inje. f One 

EO'H "EKCPusi^a-Dr " Mamiiiy witn 
AcCufTiuitlor 

iNC IntrerrtsM Wtmo'> 6y One 

INX i-icrsrrvenl Inde™ J< by One 

IHY in; 'efTi^rif indei* V by One 

JMP Ju^ip ta Mt" L0C*iiOn 



LDA Load flccbimLjiiior i*wrin Memor>|r 

LDX Load lnd«i X wiiri Msmorv 

LDV Load Inden Y wilti Memorv 

L5I1 ShiH RtghE one Bil 'Msmpry or 

NOP No □{^Graeio^T 

□RA "OR' Mrmory Hiitin Acturnulatar 

PHA Pusri flCcLjmuliior en Sl*cJi 

PHP Push Practssar Status irn SfStli 

PLA Pull Accumulator from 5lac:4i 

PLP Pull PJ6C*H0r SlUwi ffom 5«cl( 

nOL One BiE LeTl 'W«fTtQ<> or 

AccumtrlBtori 

BOR Flci-lAl* Out Sif RiffPif iMenno'y Pf 

Accijmijlateir' 

BTI Helurn liom Interrupt 

HT& Rtlurn imm ButirouiinF 

SBC Subtract Memory from Accumuiaiur 

SEC Set Carry Flag 

SEP Sf t pieomai Mode 

SE( Ser inverruDf DuaDie Siarua 

STA Siare Accummalor in Memory 

STX Slara IrnJsA X in Memary 

STT SlOf* JrHj*ii ¥ in Memory 

TA.I TrinSfflr ACCurTulitor [q In^^ki X 

Tat Transtar Accumuiarar id (f*a*jc T 

T5X Tffnster ^lacnt FQini^r lo hnciflx X 

TXA transtcr Indri X lo Accurrulailor 

TKS Transler Indti It 1Q SlJCh Pomler 

TTA Transfer inde* V lo Aticurnuislo" 
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ACCUWULATOH 



INiDEX REGISTER V 



INDEX REGISTER X 



15 



PCH 



PCL 



PfllOG^AM COUNTER 



STACK POINTER 



N 


"1 


a 






c 



PROCESSOR STATUS REGISTER 



. CARRY 

. INTERRUPT DISAQLE 

■ DECIMAL MODE 

■ BREAK COMMAND 
- OVERFLOW 

■ NEGATIi/E 
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1 



Instruction Codes 





Opiritlcin 


AjtlreLiini 


hm 


HEX 

DP 


No 

Byiei 


"P" Sniiii IliB 

N Jt 1 g V 


ADC 

atcumuFa'tQi win carry 




■ni 1 iii^u IE 

Zera Pagf 
Je'A Page 

AbMllJl* V 

1 ■ n r^ar^i' ■ V 1 

(iridiipcii V 


AflC 'Qfstt 
ADC OptE 
ADC OpcrX 
ADC Opcr 
AllC Dcc4,X 
AK Op*r f 

null lUt^Gi 

AOC tOcen ¥ 


^ 

SD 
7D 
7i 
61 

71 


3 

3 
? 
2 


^ \ s — 1. 


AND 

"AND" meinorv 
acjcumulitor 




ImiTiedi.iie 
Tern PjgE.X 

A he n li iFp 

Ab^oluit X 

MnatirM"! Vl 

1 1 1 iVLi 1 

iinfliffEM.v 


AND »Ocei 
AND Opfr 
AKP Dp«i.X 
AND OcKr 
AMD Ci[»Ei X 
AMD Oper.V 
AMD JQpei XI 
A NO lOperl t 


Z9 

^ 

3D 

?1 
31 


3 
3 
3 

2 


\ \ 


HSL 

Shift IcTi ont W 
lUemQry Qi AccumLililorl 


(See Figurs 1| 


Accumuliiwr 
Zero Page 

?i*r fi Pjinp !i! 

t CI LI r Hsy t n 

ADSDJUtP 

AbEDiufe -i 


ASL A 
ASL Ope' 
A$|. OpCf.K 
ASL Dpei 
ASl Op*iX 


DA 
DG 
1G 
DE 
1E 


\ 

2 
2 

3 
3 


V^'i' 

— ^ ■■ 


BCC 

Bfancli on carry clfai 




Rtl 3l IV? 


BCC Offfr 










Biancti on C* 1 


Retalive 


ESCS Oper 


BO 


2 




m 

Branch gn rt&tilt JCtB' 


Brinch pn ^- ] 


RtlSt'^f 


SEC OfKi 


FO 


7 




BIT 

Test bJi$ m mEmory 


A^ U 'N. 


Zero Pggi 
AbifrluliE 


aiT'' Ope' 
9IT'< Dper 


5^ 
£t 


7 

i 


M?>' -Mfi 


BMI 

Branch on rEaull ITiiiiilS 


Etrani^h gn H- 1 




BMI (hOEF 


3D 


2 




BNE 


Biinch an Z' Q 


Rcldlive 




[» 


2 




BPL 

Branch tin I»ul1 plus 


Branch ftn N'ffl 


Rel^live 


BPL ope' 


ID 


2 




BRK 


Forced 
Inlef uol 
PC'! t P t 


Implied 


emc2 


00 


1 


-- 1 -- 


BVC 


6r3.nc^ an V D 


Rfiain^e 


BVC Qpei 




? 





Nola 1 : Bils 6 and 7 are translerrsa XO ihe sLaius regiBlar. If Ihe result of A AtJD M is zero. 
I hen Z = i: oiherwise Z -■ 0. 



NolB 2, A BRK command cannal be masked by 3etlii>9 I, 
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WEJ 








Dpi'Mtliin 




Lin Quite 






r Siiiuii nm 








Nirm 




B||1H 


H J C 1 D U 


BVS 














Brancn DJ* ■pvfuio* set 


Brancfi on V- • 






7n 


? 




CLC 














ClF3r carry fiaj 


-^C 






1S 




— ■ - D 


CLD 

















-*c 


Implied 


clb 


D£ 




-a 


CLI 


















1 |r] p 1 ^{j 


ClI 


5fl 







CLV 
















G 






HB 




u 


CMP 
















A — W 




CMf ■dii-e'r 


ca 


? 


^ 


JciTurTi'uratQi 






CMP Gpti 




2 








Ztro PjB< 


CMP Cpc f 




2 










t^Wr llpe< 


LLr 












CMP DptF K 


DD 


3 










CMP Opt' V 


Dg 


3 








iMdireci XI 


CMP lOpcrXl 


ti 


? 








llnrliifrlE V 




91 


■J 




















X - M 


rmJTieij-arf 




?o 




V \. 








CPS Ojwr 


E4 


3 








AbSDlulE 


CPX Otter 


EC 


3 




CPT 
















V - M 


imneiJ-alf 


CP^ -CtpfT 


CO 


2 


V ^ V 


inflM r 






CPY Opci 












AQsalult 


CPr Oner 


cc 


3 




DEC 
















M - 1 — M 


Zero PjQ« 


DEC OOBr 






v'v'" 






Ztro Page x 


Die ClEwr.X 


06 










AQ^itlul'E 


GfC 0[>er 


CE 


3 








ADSthlUl*.!t 


DEC Opei.Jt 


□E 


a 




















t - 1 — K 


ifnjsiieff 






T 


V V 


Cn ■one 














D£Y 


















Imjlietf 






1 




Qjf onr 
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Qprntllfl 


JLlttiuliij 


L»rtBiii(i 


IIP 


Ng 


P" Slitui Rii 


DRicr kptlan 




Fii'H 


C>h 


BflU 


NIC 1 D V 


EOH 
















A V M — A 


liTimflflialfl 


[an tapbt 


49 


2 








let a Piflt 


EOH Oper 




? 










EOH Op» X 


55 


? 










EDR Opei- 


« 


2 








Ab^DtulC X 


EOR OpcT.K 




3 








A&iQiurf 1 


tOR fflper y 


59 


3 












41 


2 








(IndiriCtI V 


Eon lapcM V 


St 


3 




Inh 














mcieneni memorv 


H 1 — M 




INC Op^r 


EB 


2 




by 9rte 




Zero Pagf.x 


INC Oper.X 


F6 


; 








INC flpitr 


EE 


3 










liNC Qper.K 


FE 






INX 












1 


|[^i:[em£fi[ inQO X bf pnii 


X ' 1 — X 


1 m piped 


1NX 


ES 


1 




INY 














inciESFieni irCei v bv one 


y ' 1 —V 


(mphed 


INU 


CB 


1 


W 


JMP 














Jump (0 ne* lucaiion' 


fPC'tl — PCl 




JMP Oper 


4C 


3 






Indirecl 


JMP lQp<rl 


bC 


3 




JSn 














Jump new lOCdtton 


PC-3 ( 






20 


3 


. . - 


laving fclu'i' iddress 
















IPC'J'i —PCH 



























Loid sC'CU'ii'Ulal'Dr 


: M 


Ini'tMdiStf 


LDA Kflper 


A9 


2 


wiih inemory 




In a PdQC 


IDA Q[Kr 


AS 


2 






Zero P^gt )t 


LDA OpsT.X 


BS 


? 










LDA 0(Hr 


AD 


3 








AbsDiure.X 


LDA Oosr.)! 


BD 


3 








AbspluEt V 


LDA Qptt i 


fl9 


a 








llndHrtct.Xf 


LBA |Op«(.Kl 


A1 










>|ln[]ireir[:i Y 




B1 






UK 












vV -- 


Loaef in-dc.ii X 




lirmvedFjlE 


LAJt nOcier 


A2 


? 








LDX Optr 


A£ 








Zefft Page Y 


LDX Opiir 


BG 


2 










l&X Osier 


AE 










AEnSDluE? '« 


LClX OperY 


BE 






LQY 














Lnafl mae- T 


M 






htf 


z 




wilh mcmoFjr 




ZeiTQ Page 




M 


? 






j^enQ Page )l 






2 










tQV Oper 


AC 


3 










IBt Oper J: 


DC 


3 





g 

■J 

3 

Li 

li 

U 
J 
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Hiair 

QiicrlDlkM 


Dutrilbon 




Jliiiintflir 
LiAguigii' 
ftrm 


HFX 
DP 
CtlH 


«■ 

Brill 


~r sijtiu Kip 


1 F D 

LSn 














''^Ihiifl rmhl nnt b4l 
^mcrnvty or ICCUmuldtof 1 


ri^ifp Finnfp 111 

Idmt ri|fUI B 1 |l 


Jbrcii mu Ijilor 

ZtrB Pag*,)! 
Absolule 
AbsaliilB X 


Lsn A 

tSfl Dpi-f 
L&H Dper.): 
L5R Owr 
L5R, Opef Ik 


4A 

» 
IE 

SE 


1 

2 
3 
3 


D v'V - 


NOP 














ha QpiTjimn 




tmpliid 


NOP 


EA 


1 



















"OH" memorji wilh 




Irnmeilii.Ee 
Page 

£1j I u r B yij . ^ 

AQsalult.K 
Abschlule.y 
ttndireci X| 
(>nBrreci|,Y 


□HA nOpti 
□RA Dpcr 
□RA nner X 
DRA Qp«r 
□RA Oper.X 
QRA Qfwr.y 
ORA (DpE! J(l 
ORA [Qperj.Y 


IB 

06 
IS 
00 
1D 
19 
Dt 
It 


2 
2 
2 
3 
3 
3 
J 

Z 


^v' 


PHA 














Pus^ iccumulamr 


M 


Impliea 


PHA 


4a 


1 





PHP 














Push p[«ces!«r s,talu'$ 
on stick 


p t 


IfFpllBd 


PHP 


n 


1 




PU 














ham stack 


A t 


ilmpltrd 


PLA 


« 


1 





Ftp 














hill piocr^ior ^tatu! 
front Slack 


P t 




PLP 




1 


From Stack 


ROL 
















iSf « Figure Z) 


Accumulalar 
lira Past 
Zero P^gp.K 
AQjQiijEe 
AbsAlLite.X 


HOL A 
ROL Optr 
HOL Oper.X 
HOL Cp*r 
ROL Op*r.X 




1 

2 
3 
3 


^^v — 


RQR 














imtmory or dtcufnulaivrl 




AtCumulalor 
2eta Pagt 
Zero PaQe.X 
Absolute 
Absalutc.X 


HOR A 
flOfl Opef 
RGR Dper X 
HOR Oper 
ROR Dpet.K 


56 


1 

? 

? 
3 
3 





Instruction Codes 



Nimi 

Deter If II en 


Qpirjiwn 


IdrireiilriD 


AiiemblT 
Form 


HEX 
OP 
Cell 




'T S-Lilui hg 
KZ U 1 V 


HTt 

Hdurn Uorv^ inlrrrupl 




Implis-Q 


RTI 


40 


1 


From Siacii 


RTS 

Return Irom subrculiFiE 


PC* PC-1 —PC 


Implied 


R15 




1 




sac 

SutiUSCl rnemar^ Irani 
actum ulilinr wim tiDir»«f 


A M C— A 


Ztii Pa^t 

AbSQlulc X 
Ati5;hlul« V 
ilirwaifecvXl 
Ortdir^dl ■H 


SBC Oper 
SBC Qpcr ? 
SBC Oper 
sac OperS 
SBC fipeiy 
SBC fOper Kl 
EBC lOperl.V 


E9 
£5 
F5 
Eff 
FO 
FS' 
ET 
FT 


2 
2 
2 

i 

3 
i 
1 
2 


\ V >■ 


SEC 


1 — C 


ImpliEd 


£EG 


38 


1 




SED 

Sc1 decimar mode 


1 — D 


i'm}!ii led 




F8 


1 




SEI 

S(l interrupr disable 


1 ^1 


rm&iieif 


SEI 




1 


1 - - 


STA 

Slare accuntul^tar 
in (Tiemoi'y 


ft -^M 


Zifrp Pag* 
2f-rn Page X 
AbsDiule 
Ab^QiuH X 
Absolul-e.V 
^Irtdirecl.XI 


ETA Opef 
STA Opec X 
STA Qp«r 

STA Qper.X 
STA Opet V 
S1A i-Opet %\ 
STA lOperi.V 


B5 
95 
SO 

w 

B1 
91 


2 
t 
3 
J 

3 

2 
2 





STX 

Stofc ifidtr X m mcmsrjf 


K -hM 


Zero PiB« 
il'tri) Pag* Y 

ADSOIuIC 


STX Oper 
STX Dper.'r 
STJf Offer 


as 

SE 


2 
2 




STY 

SiQre miita r m mtmarj' 




Z(r« Page 
Ab^alulc 


STV Offer 

Dper.X 
STV Oper 


94 


? 
2 




TUX 

Traniki accumuFatot 


ft —X 


Implied 


tAX 


Aft 


1 




T«Y 

TranjlieT scrrumwl^lar 
Id ifldes. V 


A — .Y 


impliFd 


TAV 


AB 


t 


vV 


TSX 

franslti HaC" [mmler 
Ip mdEX X 


S —X 


Imp'liBd 


TSX 


fiA 


1 
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i 



Nttni 

□ t tC:rlp||i|HI 




AddrcsilrtQ 


Fflrm 


Ha 

OP 


Ma 


"P SLi^yi Rig 
H Z £ t D ir 


TXA 

Transfer indflfi K 
111 dCCumulHIur 


X — A 


Implied 


IXA 




1 


V 


TXS 

ar^E.k Doinfer 


K 


ImpJied 


TXS 




1 




TYA 


Y —A 


IrrplfeiJ 


TYA 




1 


vV 
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Hex Operation Codes 



00 - BH« 

Dl - ORA - 'Inaireci Ki 
02 - 
CO- 
O* - 

D5. — ORA - Zero P^Si^ 
K — ASL — Zbtc p«9B 
OT - 

OB - PMP 

M — ORA — Immadiite 
GA — ASL — AccufnuHtor 
OB - 
DC 

OD — OHA - AbS&lule 
OE — ASL - Absolut* 
OF ^ 

ID - BPL 

n - - (Ir^Oirecli. V 

^^ - 
13 - 
u — 

15 — ofiA — ZeFo P*ge. X 

16 — ASU — Zbfd Pi.g«. X 

ir - 

IB — CLC 

119 — ORA - Abnoium, V 

■1A - 
IB - 
■VC - 

ID — ORA - Absoluts X 
IE — ASL — Atjaolure- X 
If - 

M- J5H 

21 - AND — ilni[Jn«:[, 

- 
23 — 

^ Bit — Zero Pafl* 
25- AND — Zero Pag* 
ZE — ROL — 2ers P»flB 

17 - 

?a - PLP 

29— AND — ImmefliHtB 
2A — BOU — AccumulMtpr 
2B — 

2C — BIT - Ab40ivia 
ZD — AND - Ab*dlul« 
?t - ftOL - Absoiule 



?f - 

3Q - BMI 

31 - AND ^ 'indiFEEli V 
3^ - 
33 - 
3< - 

35 — AND — Zefo Page. K 

36 — HDL - Jero Piige X 

- 

38 - SEC 

39 - ^^NO — AhsolulE ¥ 
3A - 

3B - 

3C - 

3D - AND ' ASi&aluEr 3< 
3E — ROL - AtiSOiitle K 
3F - 

40 nil 

■<1 - EDR — UFifliretl. XI 
4? - 
*3 - 
44 - 

41 - EOR — sJ Pige 
4i - LSR — Zera Page 
A7 — 

4a — PHA 

49— EOH— 'mm»ami« 
4A — LSR — AccumulKlDr 
4B - 

4C - JMP — Afrsoluie 
4D — EOR - Absolute 
4E — LSfl — AhMluT* 
4F - 

50 — BVC 

51 — EOn llndireai. V 

52 — 

53 - 

54 — 

55 — EOR - Zero Pt^t. % 
£6 — LSR — i»ra Page. X 
57 - 

5fi— CLI 

56 - EDH - Absolulf . V 
5A - 

se - 

ic - 

5D — EOH — ADiolUIB. S» 



5E — LSfl - AbsQlult, X 
SF - 

60 - RTS 

61— APC — lnaif*Ct Xi 
62 - 

aa — 

54 - 

65 — ADC - Ztro Pige 

66 - fiOR — Zera P*9# 

67 - 

6B - PL* 

69 — ADC — ImmeOiBle 
6A — HOR - acc ym uiaiar 

se - 

EC - JMP — Indited 
60 — ADC — Abs&lule 
6£ — ROR — Absolul* 
6F - 

70 - BVS 

71 — ADC - Mnaifeci', V 
7? - 

?3 - 

74 - 

75 - A&C — Zero Page- X 
?6. - nOR - Z*r0 Page X 
TT - 

?8 - SEI 

73 - ADC — Absolula. V 
TA - 
70 - 
7C - 

7D - ADC — AbsokLfie. x 
7E — nOR — Ab&Qliile X 
7F - 
BD - 

at - STA — llncKrecl, Mi 
82 - 
B3 - 

—STY - ?*-c PjigB 
B.5 — STA — Ze«0 PtflS 
— STX — Zero Pag? 
B7 - 

eS - DEV 
S9 - 

8A - TXA 

ac - STt - A&sQlule 
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S.D - 


STA - 




34 — 




- 2^'^ P-SQe Si 


DS 






SE - 


STk — 




as - 


lDA 




DC 






— 






H& — 


LDX ' 


ZtiO PiQC V 


DD 




CMF 


» ^ 


BCC 




B' — 






D£ 




DEC 




ST* - 




B6 — 


CLV 




OF 






- 






59 — 


LDA ■ 


- Ahso'vJie V 


EO 




CPX 


33 - 






BA — 


TSy 




£■< 




SBC 


94 — 


STV - 


Zero PaijP ^ 


30 — 












95 — 


&TA — 


Z'Cro PaqE 1 


BC — 


L DV ■ 


— A't&DlutG' % 


t3 






96 — 


STx — 


Zero PflSJB' 't 


SD - 


LDA ■ 


— AnsciuiF X, 


Ed 




CPU. 


97 ~ 






BE — 


lDK 


- Ap^^lucp V 


E5 




BBC 


95 — 


IVA 




BF — 






E£ 




INC ' 


59 — 


STA — 




CO — 


CP*! ■ 


- Imrpedia!* 


ET 






9A 


TXS 




Ci — 


CMP 


— i n d 1 re C E X 


Ee 




INK 


9B — 






C2 — 






Eg 




SBC 


9C — 






C3 - 






EA 




NOP 


flD — 


STA — 




C4 — 


CP> 


— Ze-'o PaflP 


EB 






— 






CS — 


CM*' 


— 2!e'o Pafle 


EC 






9f — 






Cfi — 


DEC 


— Zff'o Page 


ED 




sec 





LDv - 




- 






EE 






A1 — 


LDA - 


Indirect X- 


Cfi - 


INY 




EF 






AJ — 


UDJf - 




CB — 


CMP 


— Irrirnedillf 


FO 






*3 — 






Ca — 


PES 




^ 1 




sec 


M ^ 


LDT — 


Zero Page 


CB — 






F2 






*5 - 


LDA - 


Zero Pige 


CC - 


Cpv 


— A&soiwie 


F3 






AC - 


LDX - 




CD - 


■CMP 


AbiOluIr 


F4 






A7 — 






ce - 


OEC 


— Absolute 


F5 




sac 


AB - 


TAV 




CP - 






Ffi 




INC 


AB — 


LDA - 




DO - 


bme 




FT 






AA - 


TAX 




□ 1 — 


CMP 


— i|r>dirpcli. V 


Fa 






AS - 






0? - 






F9 




sac 


AC - 


L0> - 


Abjolgte- 


03 - 






FA 






AD - 




D* - 






FB 






- 


LDK - 




D5 - 


CMP 


— zire X 


FC 






AF — 






D6 — 


□ EC 


- itfo Fag*, X 


fD 




SBC 


eo ~ 


BC& 




D7 - 






FE 




INC 


fit - 


LOA - 




DS - 


CLD 




FF 






e.2 - 






□ i - 


CMP 


- Aesoigte ¥ 








63 - 






DA - 













Zptl' Pagi' 
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Appendix B 



Tables 



This appendix contains copies of the tables you will need to refer 
to a lot, for example, ASCII codes and soft-switch locations. The 
figures all have their original figure numbers so you can refer to 
the refevant sections in the text. 



Table Keyboard Memory Location 

Locations Hex Oecimal Pescrlptfon 

tCDOD ^31 - 1 G38^ Keybaard data and strobe 

(CO I 43168 ' 1 6388 Any-key-down flag and Clear-slrobe swl1ch< 
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Tat3le2-3a Keys and ASCIf Codss 

Codes are shown here in hexadecimal 
to find tlie decimal equivalents, use 
TatJio 2-4. 



Key 


Normal 


Control 


Shift 


Bot 


1 

1 DELETE 


tr 


7C 

tr 




i r 


1 ■ ^ ^ ^ A n Cm f^L 1 

\ LEF T-flRHDW 


Uo 


fid 


on 


Ofl 


1 T|0|E 1 


nQ 
uy 




09 


09 


1 DuWN-ftHHQW 1 


n A 


nil 


OA 


OA 


'1 1 lO — AiDDnU 1 

i| Ur mKKUW I 


DR 

UD 


OB 


OB 


OB 


1 T 1 1 rn VI 1 

1 RETURN 1 




on 


OD 


OD 


ra I" f LIT * fi fStTl i.i 

\ RIGHT-hRRQW f 


1 Zi 




1 5 


1G 


[esc I 


1 Q 
ItJ 


1 H 
1 □ 


1 Ir 


1 


space 








20 


* ■ 




il / 




32 












~ — 




^Pl 


3r 


1 p 

1 r 




e t 




-lie 


IF 


/7 






jr 


IF 


0) 


JU 


JiU 


?Q 




1 ! 


31 


31 


^1 




2@ 


3Z 


oa 


40 


00 


a# 


33 


33 


23 


23 


4S 


34 


34 


34 


24 


5% 


35 


35 


25 


25 




36 


1E 


5£ 


IE 


7ft 


37 


37 


26 


26 


8* 


38 


38 


2A 


2A 


9( 


39 


39 


2B 


2Q 




3Q 


38 


3A 


3A 


= + 


3D 


3D 




2B 


u 


53 


IB 


7B 


IS 


M 


BC 


1C 


7C 


1C 
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TabEe2-4 The ASCII Character Set 



Dec 


Hex 


Char 


Dec 


H«x 


Char 


Dec 


Hex 


Char 


Dec 


Hex 







00 


NUL 


32 


20 


SP 


G4 


40 


@ 


96 


60 




1 


01 


SOH 


33 


21 


1 


65 


41 


A 


97 


61 




2 


02 


SIX 


34 


22 




6G 


42 


B 


96 


62 


b 


3 


03 


ETX 


35 


23 


# 


67 


43 


C 


99 


63 


c 


4 


04 


EOT 


se 


24 




6a 


44 


D 


100 


64 


d 


5 


05 


ENQ 


37 


25 




69 


45 


E 


101 


65 


e 


6 


06 


ACK 


38 


26 




70 


4S 


F 


102 


66 


f 


7 


07 


BEL 


39 


27 


. 


71 


47 


G 


103 


67 


g 


B 


OS 


BS 


40 


29 


( 


72 


46 


H 


104 


68 


h 


9 


09 


HT 


41 


29 


) 


73 


49 


1 


105 


69 


i 


10 


OA 


LP 


42 


2A 




74 


4A 


J 


106 


6A 


j 


11 


OB 


VT 


43 


2B 


+ 


75 


4B 


K 


107 


6B 


k 


12 


OC 


FF 


44 


2C 




76 


4C 


L 


106 


6C 


1 


t3 


OD 


CR 


45 


2D 


_ 


77 


4D 


M 


109 


6D 


m 




OE 


SO 


46 


2E 




78 


4E 


N 


110 


6E 


r. 


15 


OF 


SI 


47 


2F 


/ 


79 


4F 


O 


111 


6F 





16 


10 


OLE 


48 


30 





80 


50 


P 


112 


7D 




17 


11 


0C1 


49 


31 


1 


81 


51 


Q 


113 


71 


q 


18 


12 


DC2 


50 


32 


2 


62 


52 


R 


114 


72 


r 


19 


13 


DC3 


51 


33 


3 


83 


53 


S 


115 


73 


s 


20 


14 


DC4 


52 


34 


4 


64 


54 


T 


116 


74 


( 


21 


15 


NAK 


53 


35 


5 


65 


55 


U 


117 


75 


u 


22 


16 


SVN 


54 


36 


6 


66 


56 


V 


118 


76 


V 


23 


17 


ETB 


55 


37 


7 


87 


57 


w 


T19 


77 


w 


24 


t6 


CAN 


56 


38 


8 


88 


58 


X 


120 


7B 




25 


19 


EM 


57 


39 


9 


69 


59 


Y 


121 


79 


y 


26 


lA 


SUB 


56 


3A 




90 


5A 


z 


122 


7A 


z 


27 


IB 


ESC 


59 


3B 




91 


5B 




123 


7B 


\ 


2B 


10 


FS 


60 


3C 




92 


5C 


\ 


124 


7G 


I 


29 


ID 


GS 


61 


3D 




93 


5D 


I 


125 


7D 


\ 


30 


IE 


RS 


62 


3E 


> 


94 


5E 


A. 


12G 


7E 




31 


IF 


US 


63 


3F 


7 


95 


5F 




127 


7F 





3 

'A 
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Table 2-6 The Display Character Sets 

Ta identity particular ctiaractgrs and 
values, refer to Table 2-4. 



Primary Character Set: 



Alternate Ctiaracter Bet: 



Hex Values 


Character Type 


Format 


Character Type 


Foj-mai 


S00-S1 F 


Uppercase letters 


Inverse 


Uppercase Isders 


Inverse 


S20-$3F 


Special characters 


Inverse 


Special characters 


Inverse 


$40-$5F 


Uppercase letters 


Flashing 


Uppercase tetters 


Inverse 


S60-$7F 


Special characters 


Rashing 


Lowercase letters 


Inverse 


seo-$9F 


Uppercase letters 


Nofmal 


Uppercase letters 


Normal 


$AO-SBF 


Special characters 


Normal 


Special characters 


Normal 


$CO-SDF 


Uppercase letters 


Normal 


Uppercase letters 


Normal 


SEO-SFF 


Lowercase letters 


Normal 


Lowercase letters 


Normal 



Tible 3-7 Low-resofution Graphics 

Cobrs 

Colors may vary, depending upon ttie 
controls on the monitor or tel^evision 
set. 



Nybble Value CoFor 
Decimal Hei 






$0 


Black 


1 


SI 


Magenta 


2 


S2 


Dark Blue 


3 


S3 


Purple 


4 


S4 


□ark <3reen 


5 


S5 


Grey 1 


6 


S6 


Medium BEue 


7 


E7 


Light Blue 



Nybble Value Color 
Decimal Hsk 



8 


SB 


Brown 


9 


£9 


Orange 


10 


SA 


Grey 2 


11 


SB 


Pink 


12 


sc 


Ltght Green 


13 


SD 


Yellow 


14 


SE 


Aquamarine 


15 


£F 


White 



Table 2-3 High-resolution Graphics 
Colors 

Colors ma^ vary, depending on the 
adjustment at the monilor or television 
set. 



Bits 0-6 



SHTOfl 



Bit 7 On 



Adjacent columns off 
Even columns on 
Odd columns on 
Adjacent columns on 



Black 1 
Purple 
Green 
White 1 



Black 2 
Blue 
Orange 
White 2 
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Tabl€f Video Display Pago 



Lowest Highest 
Diaplay mode Page Address Address 



•Note: SO-column mode uses Ehe 
lQ24-bvte page-l locations ir both 
mam and auxiliarv Tnemory, The 
PAGE2 5wiich is used to selecl one 
or Ihe oilier far slorrng data (see I he 
section 'Display Moda Swilcliing"). 



AO^IumnText. 1 i-IOD 1 0?4 *7FF 

Low-resolution 

Graphics 2 *S0O £0^8 *BFF 3071 



eOH3olumnText 1* 1400 *7FF 2047 



High-resoiution 1 *£t)OD 8192 *3FFF 15383 

Graphics 

2 140 163S4 *5FFF £4575 
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Table 2-10 Display Soft Switches 

[1 1 This mode is only effecliye wlien 
graphics-mode swilch is ON. 
{2] This switch has a dilferenl function 
when the 80-colLjnin texl card s 
auxiliary lent page \s enabied for 
writing, Refer to the rexl section, 
"Address-ing Dispiay Pages Direcily.'* 
(3) This switcn changes (he funclian of 
the switch for addressing the 

ajjfiliary text rnemory on the exlended 
80-column texl card. The next section 
describes how to do Ihis, 
{4) Reading (his focation returns the 
state of ihe vertical blanking 
signal VBL . The runction of VBL is 
described in Chapter 7 in the section 
Video Output Signals." 



Name 


Function 


Hex 


Location 
Decimal 


Notes 


ALTCHAR5ET 


AEternale char, set on 
AElernate char, set off 
Read flLTCHAGSET SWfUch 


•COOE 
iCOl E 


49167 
491 6& 
49182 


-16369 
-1637Q 
-163S4 


Write 
Write 
Read 


TEXT 


Text mode on 

Text mode off {graphics] 

Read text switch 


ICD51 

SCDBO 
tCOl A 


49^33 
492 3? 
491 79 


-16303 
-16304 
-163SS 


Read 


MIXED 


Mixed-mod© on 
Mixed-mode off 
Read MIXED switch 


*C0E3 
tCDS£ 
tC015 


49235 
49234 
49179 


-16301 
-1S302 
-1G3S7 


t 

Read 




Page 2 on 

Page Zoff (Page 1j 

Read PAGE2 switch 


*coss 

fCD54 
CCD1 C 


49237 
49336 
431 BQ 


-16S99 
-16300 
1 S356 


2 
2 

Read 


HIRES 


HI res mode on 
Hi res mode off 

Read Hi Bf 5 suviirh 


tCD57 
*C056 


49239 
4923S 
491 81 


1G297 
- 1 G29B 
-16355 


1 

1 

Read 


SOCOL 


eo-colurno display on 
80-coiumn display ofl 
Read SOCDL switch 


*COOD 
ICDDC 
tCOlF 


49165 
491 G4 
49183 


-16371 
1G372 
-1G353 


Write 
Write 
Read 


aOSTDGE 


Store in ayxiliary memory 
Store in main memory 
Read aOSTQRE switch 


ICDDI 
IC018 


49153 
49152 
491 7G 


-163B3 
-16394 
-1E3G0 


Write, 3 
Write, 3 
Read 


VBL 


Read vertica9 t>lanking 




49177 


1G3S9 


Read. 4 
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Table 2-11 Annunciator Memory Annunciator Address 

LosaHons No. Pin" Slate Ikiclmal Hex 



'Pir numbers given are for the 16-pin 

IC connecloron Ihecircuit board. 15 off 49240 -1G29G *C058 

on 49241 -1629S tCOSS 



1 14 Off 

on 



2 13 off 

on 



3 12 off 



4924£ -ie£94 *CQSA 
492-13 -16293 *COSB 



49244 -16292 tCOBC 

49245 -16291 *CQ5D 



4924G -tG290 «COSE 
49247 -16289 *C05F 
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Table 2-12 Secondary I/O Memory Address 

Locaiions Function Decimal H«x Motes 



For connedor identification! and pin 

numbers, refer to Tables 7-17 and Speaker 49200 -1G33S tC030 Read 
7-ia. 



Cassette Out 491 -16352 *C020 Read 

Cassstteln 492^9 ^8296 »COeo Read 



Airuncialor On 


49241 


- 1 629S 


• 0099 




AnrurtcialorOOff 


49240 


- 1 629G 


fOOBQ 




Annjriciator i On 


49243 


- 1 6293 






Annurcialor i Off 


49242 


- 1 G294 


*C05A 




Annunciator 2 On 


4924S 


16291 


ICOSD 




Ar^nyncialOr2 Off 


49244 


- 1629^ 


*C05C 




Annunciator 3 On 


49247 


- 162B9 


»COSF 




Annunciator 3 OH 


49246 


-16290 


tC05E 




Slrobe Outpui 


4921 B 


-16320 


»C040 


Read 


Switch Input 


49249 


- 1 6297 


• C061 


8eed 


( laPEN-flPPLE^ ^<ey) 










Switch Input 1 


49250 


-162 as 


tC0G2 


Read 


(fsbLlD-APPLEl key) 










Switch Input 2 


492B1 


- 1 6285 




Rsad 


AnaFog Inpui Rese! 


49264 


-16272 


10070 




Analog Input 


492B2 


-16284 


tC0G4 


Read 


Analog Input 1 


49253 


-16293 


tC065 


Read 


Analog Inpjt 2 


492S4 


- ie^92 


IC066 


R^ad 


Analog Input 3 


49255 


- 16291 


*C0E7 


Read 
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Table 3-3s Corirol Characters with 
CDUT1 

{1 ) Only available when 80-column 
firmware is active, 
(2] Only works from the keyboard. 
(3) Doesn t work from the Jte/ijoard. 



Central 
Charac1«r 



ASCII Apple He Action Taken by CDUT1 
Name Name 



Nates 



CONTROL I - G (BEL) bell 



Produces a lOOO Hz tone lor 
0.1 second. 



[ CDMTHOL I - H (.BSl backspace Moves c jrsor position ona 

space to the left; from left edge 
of window, moves to nght end 
of line above. 



1 COHTRDL J - 


J 


(LF) 


line feed 


1 CONTROL 1 - 


K 


{VT) 


clear EOS 


1 CONTHDL 1 - 


L 




Clear 


1 CDNTROTI - 


M 


tCR) 


return 


rCDNTHQL 1 ' 


M 


(SOI 


normal 


[CDNTRDlJ- 


a 


ISI) 


inverse 


1 CONTROL J - 


Q 


lOClJ 


40-Mlumn 


j CQNTRDLl- 


R 


(DC2) 


80-column 


[ COHTRDL 1 - 


S 


(DS3] 


stop-liSi 



Moves cursor fxisrtion down to 
next line in window; scrolls if 
needed, 

Clears (rom cursor posilion to 1 
the end of the window. 

Moves cursor position to upper 1 
left corner ot window and clears 
window. 

Moves cursor position to iefl 
end a\ next line in window; 
scrolls if needed. 

Sets display format normai- 1 , 3 

Sets display lormal Inverse. 1, 3 

Sets display to 40-CDlumn. 1 

Sets display to SO-column. 1 

Stops sending characters to the 1 , 2 
display, until a key is pressed- 
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Table 3-3b ConlrDl Characters with 
COUTi , continued 

(1 ) Only avajlable Ahgn QQ-cplumn 
firmware is active. 
i_2) goloXY IS not supported under 
BASIC: see the Apple Pascaf 
Operstmg System ReterencB Manual. 



Table ^4 Test Window Memory 



Control 
Ctiaracter 



ASCII Apple lie 
Name Name 



Action Taken by caun 



Notes 



|CDMTRDL| - ^ {NAK) qjtt 



I CONTROL j - V (SYN) SCfqII 



[COHTROLj - 14 (ETB) acrolJ-up 



1cdmtrql"| - ¥ (EM) home 



[CDWTROL l ' Z [SU BJ dear line 



[cOMTrdlJ- \ {FS) fwd. space 



[CDMTROL 1 



(GS) clear EOL 



ICONTRDL |- ■- (RS) gotoXY 



Deactivates dQ-EOiLimn 
firmware, homes curaar. 
and clears screen. 

Scrolls the display down 
one tine, leavmg the cursor 
in the CLrrenl position. 

Scrolls the display up one 
linie. leaving !he cursor in 
the current posillon. 

Moves cursor position to 
upper left comer of window 
{bul doesn't ciearl. 

Clears the line the cursor 
posft^on is on. 

f^oves cursor position one 
Space to !he right; from 
righl edge of window, 
moves it to ^eft end of line 
belov/- 

Clears line irom cursor 
postMon to Ihe righl edge of 
the window. 

Using the next two 
characters, minus 32. as 
QOB-byte X and. Y values, 
moves the cursor position 

io cH=x. gv=Y 



1,2 



Window Location Minimum hformat Values: Maximum Values: 

Parameter Value: 40col. flOcol- 4acol. ' BDcoL 

Dec Hex Dec Hex Dec Hex Dec Hex Dec Hex Dec Hex 



Lei Edge 


32 


S20 





so 





SO 





$0 


39 


E27 


79 


S4F 


Width 


33 







so 


40 


$23 


BO 


S5D 


40 


$28 


fiO 


sso 


Top Edge 


34 




a 


so 





SO 





$0 


23 


$17 


23 


$17 


Bottom Edge 


35 


*23 


1 


Si 


2A 


$13 


24 


Si 8 


24 


$ie 


2A 


$18 
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Table 3-^ Escape Codes 

(1 ) Old-style cursorKMntrol key: 
see text. 

(2) Curscn-control key; see tejft. 

(3) TriiB code tundions orSy when the 
SOcolumn lintiware is active. 



Escape CcKfe Function Notes 



[ESC 1 


@ 


Clears the window and homes the cursor 




[ESCj 




Moves the cursor up one line 


1 


[esc] 


B 


Moves Ihe cursor riglif one space 


1 


1 ESC 1 


C 


Moves Ihe cjrsor Isft one space 




1 ESC 1 


□ 


Moves (he cursor dowr one line 


1 


f ESC 1 




Clears to tha and of Iha lina 




! ESC 1 


F 


kjmnn - > likj LI LAf ilUI 1 1 Ul Hi ID TT 1 1 lu^ 11 




1 

[ESC 1 


1 


Moves the cursor up one line and turns on 


2 


1 1 

1 ESCj 


t 


escspG mode 




|esc| 




Moves the cursor left one space and turns on 


2 


|esc| 




escape mode 




lescl 


K 


Moves (he cursor right one space and turns on 


2 


lEscI 




escape mode 




1 ESC 1 




Moves the cursor down one line and turns on 




|esc| 


* 


escape mode 




|esc j 




Turns on re&tficted-case mode 


a 


[ ESC ] 


T 


Turns OR restrtcted-case mode 


3 


flsc] 




Switches to 40-eolumn mode, homes 


2 






cursor, and clears the screen 




|esc I 


a 


Switches to 80-column mode, homes ttie 


3 






cursor, and clears the screen 




IescI 


cdhtrqlI - a 


Deactivates the eO-co!umn firmware 


3 
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Table 4-5 Bank Sslect Swtlches 

(1 ) This swilch wnte-enables HAM 
and read-enal)les ROM. 
i2) Two successive reads to this 
switch enables RAM both for reading 
and writing. 



Switch Write Read Read 4K RAM Bank: 

Address RAM RAM ROM First Second Notes 





* 




■ U U 1 ■ 












SC083 * 




* 2 


*C084 






*C08S • 




« 1 


tC086 






*C087 • 




• 2 








tcGes * 




1 








tCQ8B « 




2 


tC08C 






tcoao 




1 


*C08E 






tcoar • 


• * 


2 
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Table 4-6 AjKilrary-memDry Select 
Switches 

(l)When BO STOKE is on. ihe PAGES 
swiicin selects mam gr auxiliary display 
memDry. 

<2]When eosTORE^s on. the HIRES 
switch enables you to use Ihe PftGEa 
sviitch to Switch between the 
high-re&nluliori page-l area in main 
memory or auxiliary memory. 



Name 



Function 



BAMRD Read auxiliary memiory 
Read main memory 
'Read RANRDswitch 



Rf^MURT Write auxiliary memory 
Write main memcrv 
Read RAMURT&w<tch 



Hex 



Location 

Decimal 



Notes 



»CO03 49155 -t63Sl Write 
»C0C2 491 54 -1G382 WrilO 
*CD1 3 49171 -1G3e5 Read 



*C005 49157 -1G379 Write 
*C004 49156 -tS380 Write 
•C014 49172 -15354 Read 



3ST0RE On: access display page *C0Oi 
Oft: use RAMRD. RftMWRT tCQ'DO 
Read SQSTGREswitch *C01 B 



49153 - 163B3 Write 
491 S2 ' 163B4 Write 
491 76 - 1 e3£0 Read 



PAGE 5 Page 2 on (Aux. memory) * C 055 
Page 2 off (Main memory) tC054 
Read PAGE 2 switch *COiC 



49S37 - 1G239 1 
4923G - 16300 1 
491 BD - 16356 Read 



HIRES On: access hi-res pages *C0S7 49239 -16297 2 
Oflljse RAMRD. RAP1WRT »COSG 49238 1629B 2 
Read HlREBswitch tCDID 49^81 -16355 Read 



flLTZP ftuxiliarystackSiZ. p. tcO09 49161 16373 Write 

Main stack a zero page ICOOS 491 SO -1537*1 Write 

Head flLTZPswitch *COlB 43174 - 15352 Read 
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Table 4-10 Page 3 Vectors Vector address Vector function 

Decimal Hex 



1 008 $3F0 Address of the subroutine that handles BRK requests 

1009 «3F1 (normally tBS, tFfl). 



ICIO t3f^2 Reset vector (sea text). 

t3F3 



1 Ql Z t3F4 Power-up byte (see texi). 



1 G 1 3 t3FS Jump instfuction lo line subroutine that handles Applesoft 

1D14 *3FG commancfs (normally t^C. *58, *FF). 

1C15 t3F7 



1016 * 3FB J ump instruct ion Id the subroutine lhat handles user 

1D17 *3F9 ( IcQNTROlI - Y) commands, 

1018 fSFA 



1013 $3FB Jump in&iructian to the subroutine lliat handles 

1 020 *3FC non-maskable inlerrupts, 

1021 *3FD 



1 022 t3FE: Interrupt veclof (address o( the subroutine inat handles 

1 023 t3FF interrupt requests)- 
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T«bl» 6-1 P«rfphflral-cBrd I/O 
Mgmorv Locations 

Note: The enabling signal is marKed 
with a. prime, to indicale that it Ss an 
active-low signal. 



Slot 


Lacatlona 


Enabled by 


t 


•C090-*C09F 


DEVICE SELECT' 


2 


•COflO-tcOAF 


I>EVICE SELECT' 


3 




DEVICE SELECT' 


4 


»CDCO-»COCF 


DEVICE SELECT' 


5 


*CODCl-»C0DF 


DEVICE SELECT' 


e 


*ca€o-icof:F 


DEVICE SELECT' 


7 


iCOFO-tCOFF 


DEVrCE SELECT' 



Table &-2 Peripheral-card ROM 


Slol 


Location* 


Enabled by 


Wemory Locations 








Notei The enaHling signal is marted 
with a prime, to indicate that it is an 
active-low slgnal- 


1 
2 


»C100-»C1FF 
*C200-«C£FF 


1/D SELECT' 
1/0 SELECT' 




3 


*C30C-tC3FF 


UD SELECT' 




4 


*c4^30-»c^FF 


I /D SELECT' 




5 
6 


tC5D0-«C5FF 
IC6Q0-»C6FF 


1/0 SELECT' 
I/a SELECT' 




7 


•C700-iC7FF 


I /D SELECT' 
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Tdble 6-3 Peripheral'card RAM 
Memory Lo&alions 

'Note; The RAM lacalions normally 
ailbcated \o slot 3 are taken over by 
any card Engialled in the auxiliary slol 



Base 
Address 


1 


2 


Slot Number 
3' 4 


5 


6 


7 


*0478 


*0479 


»G47A 


*C547B' 


*0fl7C 


»047D 


*047E 


*047F 




*04F9 


«04Fft 


*O4F0* 


*04FC 


tOAFO 


*04FE 


*04FF 


• 0S78 


♦ OS 79 


*057P 


*057B* 


*0S7C 


t057D 


»057E 


I057F 


*Q5FS 




l05Ffl 


*05FB* 


«OSFC 


tOSFD 


*osfe: 


iOEFF 




10679 


t067A 


»0B7B* 


*067C 


»0e7D 


*0E7E 


*oe7F 


«D6FS 


iOeF9 


• 06FA 


*OSFB* 


*06FC 


»06FD 


*OEFE 


*06FF 


*077S 


10779 


J077A 


*077B* 


t077C 


t077D 


»077E 


t077F 


ta7F8 


«07F9 


tri7FA 


ia7FB* 


tO?FC 


*07FD 


*07FE 


• 07FF 
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Table 6-4 Peripheral-card I/O Base 
Addresses 



Base 



Confiector Number 



Table I/O Memory Switches 



A, #4 ram A A 


1 


9 


3 


4 


5 


ft 


7 


icoeo 


tCD90 


ICQflQ 


«COBO 


»CDCO 


SCDDD 




ICOFO 


*coei 


»C091 




■ CQS1 


ICOCt 


*C0D1 


tCQEl 


tCOFt 


ICDS£ 


9cos^ 


*C0A2 


*CDB2 


»C0C2 






tC0F2 


IC093 


IC093 


IC0A3 


fCOBi 


1C0C3 




*CQE3 


*C0F3 


<C0S4 










tCOD-t 


*CQE4 


tC0F4 


fCOBS 


IC095 








tCODS 




tCOFS 


tCOB€ 


*C096 






ICOCG 


*C0D6 


tCOGB 


tCOFG 


tC087 


tC097 


*C0A7 


«C0S7 


*C0C7 


*C0D7 


*C0E7 


JC0F7 


tcoea 


tC098 




«COBB 


tcoce 


tCODS 


tCOEQ 


IC0F8 


tcoas 




IC0A9 


tCDB9 


*C0C9 


tcong 


*C0E9 


»C0F9 


tC08A 






SCQ8A 


tCOCfl 


tCODA 


*COEA 


JCOFfl 


tCQBB 


tC[)9B 




tCDBB 


SCOCB 


tCODB 




ICOFB 


»COBC 


IC03C 


*COAC 


tCDBC 


tcocc 


JCODC 


*coEa 


tCOFC 


tC08D 


1 C D3D 


*COAD 




tCQCD 


*CDDD 


*COED 


»COFD 


SCOSE 


tC09E 


*COAC 


ICQBC 


tCOCE 


I CODE 




tCOFE 


ccoer 


tC09F 


*COflF 


tCCBF 


*COCF 


ICODF 


<COEF 


*COFF 





Name 


Function 


Location 

Hex D^fmal 




Holes 


5LaTC3R0?1 


Slol ROM a1 1C30 


tnoQB 


49163 


-16373 


Write 




Internal ROM »C30D 




49t6S 


-16374 


Write 




Read SL0TC3RnM switch 


tCOl 7 


491 7E 


-1G361 


Read 


SLOTCXRQM 


Slol ROM at *CkO0 


*CQ07 


491 59 


-16377 


Write 




Internal ROM at (CkOO 


tcooe 


49158 


-1G37B 


Write 




Read SLaiCxROM switch 




491 7 3 


- 1 6363 


Read 
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Appendix C 



Directory of Built-in 
Subroutines 



Here is a list of useful subroutines In the Apple lie's Monitor. To 
use these subroutines from machine-language programs, store 
data into the specified memory locations or 6502 registers as 
required by the subroutine and execute a JSR to the subroutine's 
starting address. After the subroutine performs its function, it 
returns with the 6502 s registers changed as described 



Warning 

For the sake of compaiabiiity between the Apple II Plus 
and the AppJe lie. do not jump into the middle of Monitor 
subroutines, The starting addresses are the sarne tor all models of 
the Apple II. but ttie actual code is different. 



BELL Output a fc>ell character 



1FF3A 



BELL writes a bell ( | CDNTRPL | -G) character to the current output 
device. It leaves the accumulator holding *S7. 



BELLI Send a beep to the speaker 



SFBDD 



BELLI generates a 1 kHz tone in the Appie lie's speaker for 0.1 
second. It scram bEes the A and X registers. 



CLREOL Ciear to end of line 



CLREDL clears a text line from the cursor position to the right edge 
of the window- CLREQL destroys the contents of A and Y. 



CLEOLZ Clear to end of line 



SFC9E 



CLEOLZ clears a text line to the hght edge of the wfndow, starting 
at the location given by base address basl indexed by the 
contents of the Y register CLEOLZ destroys the contents of A 
and Y. 
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CLREOP Clear to end of window *FC4a 



CLRSCR clears the low-resolution graphics display to black. If you 
calt CLRSCR while the video display is in text mode, it fills the 
screen with inverse-mode at-sign (@) ctiaracters. ClRSCR destroys 
the contents of A and Y. 

CLRTOP Clear the low-resolution screen *F836 

CLRTOP Is the same as CLRSCR (above), except that it clears onty 
the top 40 rows of the low-resolution display. 

COUT Output a character * ^^^^ 

cnuT calis the current character output subroutine. The character 
to be output should be in the accumulator. couT calls the 
subroutine whose address is stored in CSw (locations *36 and *37). 
which is usually the standard character output COUTI . 

C0UT1 Output to screen *fdfo 

CDUT1 displays the character m the accumulator on the Apple lie's 
screen at the current output cursor position and advances the 
output cursor. It places the character using the setting of the 
Normaiyinverse location. It handles the control characters 
[return 1 , linefeed, backspace^ and bell. It returns with all registers 
intact. 



CROUT Generates IRETURnI •FD8E 



GROUT sends a I RETURN I character to the current output device. 



CHOUT1 rRETURN | with Clear • FD8B 

CR0UT1 clears the screen from the current cursor position to the 
edge of the text window, then calis grout. 

GETLN Get an input line with prompt •FD6A 

GETLN is the standard input subroutine for entire fines of 
characters, as described in Chapter 3. Your program calls GETLN 



CLREOP clears the text window from the cursor positfor> to the ^ 
bottom of the window. CLREOP destroys the contents of A and Y. I 

CLRSCR Clear the iow-resolution screen * Fe3£ 



218 Directory of Bullt-tn Subroutines 



J 

J 

U I 

3 
J 



with the prompt character in location *33; GETLN returns with the 
input line in the input buffer (beginning at location *20 0) and the 
X register holding the length of the input line, 

GETLNZ Get an input line *FD67 

GETLNZ is an alternate entry point for getln that sends a carriage 
return to the standard output, then continues into GETln. 

GETLN1 Get an input line, no prompt *FD6F 

GETLNi is an alternate entry point for getln that does not issue a 
prompt before it accepts the input line. If, however, the user 
canc els the input line, either with too many backspaces or with a 
I CClNfROL~| 'X. then GETLNi will issue the contents of location 
* 33 as a pfompi when it gets another line. 

HLINE Draw a hofizontal line of blocks »F8i 9 

HL INE draws a horizontal line of blocks of the color set by setcol 
on the low-resolution graphics display- Cali hline with the vertical 
coordinate of the line in the accumulator, the leftmost horizontal 
coordinate in the Y register, and the rightmost horizontal 
coordinate in location »£C. hline returns with A and Y scrambled, 
X intact. 

HOME Home cursor and clear *fc58 

HOME clears the display and puts the cursor in the home position: 
the upper left corner of the screen. 

lOREST Restore all registers J FF3F 

IDREST loads the 6502's internal registers with the contents of 
memory locations *45 through *ia. 

iOSAVE Save all registers *FF4A 

I OS AVE Stores the contents of the 6502's internar registers in 
locations *45 through «49 in the order A, X, Y, P\ S. The contents 
of A and X are changed and the decimal mode is cleared, 

KEVIN Read the keyboard IFD1B 

KEYlM is the keyboard input subroutine. It reads the Apple lie's 
keyboard, waits for a keypress^ and randomizes the random 
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number seed at *4E-I4F. When a key is pressed, <ey]n removes 
the blinking cursor from the display and returns with the keycode 
in the accumuiator. KEY in is described in Chapters. 

MOVE Move a block of memory iFEEC 

MOVE copies the contents of memory from one range of iocatfons 
to another. This subroutine is the same as the move command in 
the Monitor, except it takes its arguments from pairs of locations 
in memory, low-byte first. The destination address must be in A4 
(»42-*43), the starting source address in A1 [*3C-t3D). and the 
ending source address in A2 (*3E-»3F) when your program calls 

NEXTCOL Increment coior by 3 »F3SF 

NEXTCOL adds 3 to the current color (set by SETCQL) used for low- 
resolution graphics. 

PLOT Ptot on the low-resolutEon screen * rso Q 

PLOT puts a single block of the color value set by SETCDL on the 
low-resolution display screen. The block's verticaf position is 
passed In the accumulator, its horizontal position in the Y 
register, plot returns with the accumuiator scrambled, but X and 
V intact. 

PRBLNK Print 3 spaces *FBAB 

PRBLNK outputs three blank spaces to the standard output device. 
On return, the accumuiator usually contains 'AO, the X register 
contains 0. 

PRBL2 Print many blank spaces «F94ft 

PRBL2 outputs from 1 to 256 blanks to the standard output device. 
Upon entry, the X register should contain the number of blanks 
to be output. If X-$00, then PRBL2 wiil output 256 blanks, 

PRBYTE Print a hexadecimal byte *FDDA 

PRBVTE outputs the contents of the accumulator in hexadecimal on 
the current output device. The contents of the accumulator are 
scrambled. 
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PREAD Read a hand control 



PREflD returns a number that represents the position of a hand 
controL You pass the number of the hand control in the X 
register. If this number is not valid (not equal to 0, 1, 2, or 3), 
strange things may happen, PREAD returris with a number from 
SOO to $FF in the Y register. The accumulator is scrambled. 

PREHR Print ERR « FF2D 

PRERR sends the word err, followed by a bell character, to the 
standard output device. On return, the accumulator is scrambled. 

PRHEX Pnnt a hexadecimal digit * FDE3 

PRHEx iprints the [ower nybble of the accumulator as a single 
hexadecimal digit. On return, the contents of the accumulator are 
scrambled, 

PRNTAX Print A and X in hexadecimal <F9ii 

PRNTAx prints the contents of the A and X registers as a four-digit 
hexadecimal value. The accumulator contains the first byte 
output, the X register contains the second. On return, the 
contents of the accumulator are scrambled. 

RDCHAR Get an input character or esc code * FD3S 

RDCHAR is an alternate input subroutine that gets characters from 
the standard input subroutine, and also interprets the escape 
codes listed in Chapter 3. 

RDKEY Get an input character *fdoc 

RDKEY is the character input subroutine. It places a blinking cursor 
on the display at the cursor position and jumps to the subroutine 
whose address is stored in KSw (locations *38 and *3Q), usually 
the standard input subroutine KEVIN, which returns with a 
character in the accumulator. 

READ Read a record from a cassette *fefd 

READ reads a series of tones at the cassette input port, converts 
them to data bytes, and stores the data in a specified range of 
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memory locations. Before calling READ, the address of the first 
byte must be in A1 (*3C-»3D) and the address of the last byte in 
A2 (J3E-3F.) 

READ keeps a running Exclusive OR of the data bytes in CHkSUM 
(»2£). When the last location has been filied, READ reads one more 
byte and compares it with chksum. If equal, read sends out a beep, 
and returns; if not, it sends "ERR"^ through COUT, sends the beep, 
and returns. 

SCRN Read the low-resolution graphics screen *FS7i 

5CRN returns the color value of a single block on the low- 
resolution graphics display. Call it with the vertical position of the 
block in the accumulator and the horizontal position in the Y 
register. Call it as you would call plot (above). The color of the 
block will be returned In the accumulator. No other registers are 
changed. 

SETCOL Set low -resolution graphics color »F864 

SETCOL sets the color used for plotting in low- resolution graphics 
to the value passed in the accumulator. The colors and their 
values are listed in Table 2-7. 

SETINV Set Inverse mode *FEeo 

SET I KV sets the dlslay format to inverse. COUT i will then display all 
output characters as black dots on a white background The Y 
register is set to »3F, all others are unchanged. 

SETNORM Set Normal mode *FEe4 

SETNORM sets the display format to normal. cnuTi will then display 
all output characters as white dots on a black background. On 
return, the Y register is set to •FF, all others are unchanged, 

VERIFY Compare two blocks of memory •FE36 

VER 1 FV compares the contents of one range of memory to 
another. This subroutine is the same as the VERIFY command in 
the Monitor, except it takes its arguments from pairs of locations 
in memory, low-byte first. The destination address must be in A4 
(*42-*43), the starting source address in A1 (»3C-t3D), and the 
ending source address In A2 (*3E-*3F) when your program calls 
VERIFV. 
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VLINE Draw a vertical line of blocks *F82e 

VL [NE draws a vertical line ot blocks of the color set by SETCUL on 
the low- resolution display. You should call vlImE with the 
horizontal coordinate of the line in the Y register, the top vertical 
coordinate in the accumulator, and the bottom vertical coordinate 
in location »2D. vlIHE will return with the accumulator scrambled. 

WAIT Delay tFCAB 

WAIT delays for a specific amount of time, then returns to the 
program that called \l The amount of delay is specified by the 
conler>ts of the accumulator. With A the contents of the 
accumulator, the delay is 1/2{26+27A+5A"2) microseconds. WAIT 
returns with the accumulator zeroed and the X and Y registers 
undisturbed. 

WRITE Write a record on a cassette »fecd 

WRITE converts the data in a range of memory to a sehes of 
tones at the cassette output port. Before calling WR I te , the 
address of the first data byte must be in A1 (*3C-<3D) and the 
address of the last byte In A2 {*3E-*3F). The subroutine writes a 
ten-second continuous tone as a header, then writes the data 
followed by a one-byte checksum. 
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Differences Between the 
Apple lie and the Apple II 
Plus 



The Apple lie is the tatest model Apple II, and it includes several 
improvemenls over the older models. The improvements and 
other differences are listed here in approximately the order you 
are likely to encounter them: ot^vious differences first technical 
details later Each entry in the list includes references to the 
chapters in this manual where the item is described. 

FuU Keyboard 

The Apple Me has a tuti B2'key uppercase and lowerc ase 
keyboa rd. T he keyboard includes fully-operationai i " SH 1 FT | 
and , CAPS L DCK I keys- It aiso includes four directional arrow keys 
for moving the cursor Chapter 2 includes a description of the 
keyboard. The cursor-motion keys are described rn Chapter 3. 

Apple Keys 

The keyboard of the Apple lie has two keys marked with the 
Apple logo. Thes e keys, called the ^ DPEN-flPPLE J and 



LSDL ID-APPLE_1 keys, are used with the i_RESE 1^1 key to select 
special reset functions. They are connected to the buttons on the 
hand controls, so they can be used for special functions in programs 

Lowercase Display 

The Apple lie can display the full ASCII character set, uppercase 
and lowercase. For compatibility with older Apple li s, the 
standard display character set includes flashing uppercase 
instead of inverse-format lowercase; you can also switch to an 
alternate character set with inverse lowercase and uppercase, but 
no flashing. Chapter 2 includes a description of the display 
character sets. Chapter 3 tells you how to switch display formats 
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optional 80-column Display 

With the addition of an 80-column text card, the Apple He can 
display 60 columns ot text. The SO-column display is completely 
compatahle with botfi graphics modes — yau can even use it in 
mixed mode. {If you prefer, you can use an old-style 80-coiumn 
card in an expansion slot instead.) Chapter 2 includes a 
description of the SO-coiumn display. 

Additional Escape and Control Keys 

The display features mentioned above (and many others not 
mentioned) can be controlled from the keyboard by escape 
sequences and from programs by control characters. Chapter 3 
inciudes descriptjons of those escape codes and control 
characters. 

Built-in Language Card 

The 16K bytes of RAM you add to the Apple II Plus by instailing 
the Language Card is built into the Apple lie, giving It a standard 
memory size of 64K bytes, in the Apple lie, this 16K-byte block 
of memory is called the Bank-switched Memory. It is described in 
Chapter 4. 

Optional Auxiliary Memory 

By installing an extended SO-column te>ct card, you can add an 
alternate 64K bytes of RAM to the Apple Me. Chapter 4 tells you 
how to use the additional memory. (Compatibility note: the 
extended 80-column text card also provides the 80-column 
display option.) 

Auxiliary Slot 

In addition to the normal expansion slots there is a special slot 
that is used either for the optional 80-column text card or for the 
extended SD-cotumn text card. This slot is identified in Chapter 1 
and described in Chapter 7, 

Back Panel and Connectors 

The Apple lie has a metal back panel with space for several D- 
type connectors. Each peripheral card you add comes with a 
connector that you install in the back panel. Chapter 1 inciudes a 
description ot the back panel; for details, see the installation 
instructions supplied with the peripheral cards. 
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Additional Soft Switches — Readabie, Too 

The additional display and memory features of the Apple lie are 
controlfed by soft switches like the ones on the Apple II Plus. On 
the Apple lie, programs can also read the settings of the soft 
switches. Chapter 2 describes the soft switches that control the 
disptay features, and Chapter 4 describes the soft switches that 
control the memory features. 

Built-in Self Test 

The Apple lie has additional built-in firrnware that includes a self- 
test routine. The self-test is intended primarily for testing during 
manufacturing, but you can run it to be sure the Apple He is 
working correctly. The seif-test is described in Chapter 4. 

Forced Reset 

Some programs on the Apple II Plus take control of the reset 
function to keep users from stopping the machine and copying 
the program. The Apple Me has a forced reset that writes over 
the program in memory. By using the forced reset, you can 
restart the AppJe lie without turning power off and on and causing 
unnecessary stress on the circuits. The forced reset is described 
in Chapter 4. 

interrupt Handling 

Even though most application programs don't use interrupts, the 
Apple lie provides for interrupt-diiven programs. For example, the 
BO-column firmware periodically enables interrupts while it is 
clearing the display (normally a long time to have interrupts 
locked out). Interrupts are discussed in Chapter 6. 

Vertical Sync for Animators 

Programs with animation can now stay in step with the display 
and avoid flickering objects in their displays. Chapter 7 includes a 
description of the video generation and the verticai sync. 

Apple He Signature Byte 

A program can find out whether it's running on an Apple lie or on 
an older model Apple It by reading the byte at location *FBB3 in 
the System Monitor. In the Appie lie Monitor, this byte s value is 
$06; in the Autostart Monitor [the standard Monitor on the 
Apple M Plus), Its value is $EA. {Note: if you start up with DOS 
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and switch to Integer BASIC, the Autostart Monitor is active and 
the value at localion *fbs3 (s SEA. even on an Apple He.) 
Obviously, there are lots of other locations that have different 
values in the different versions of the Monitor; location *FBB3 was 
chosen because it will have the value $06 even in future 
revisions of the Apple lie fvflonitor. 

Hardware implementation 

The hardware implementation of the Apple Me is radically different 
from the Apple II and Apple II Plus. Three of the more important 
differences are 

• The custom ICs: the lOU and MMU; 

• The video hardware^ which uses ROM to generate both text 
and graphics; 

• The peripheral data bus. which is fully buffered. 
All of these features are described in Chapter 7, 



228 



Apple lie and Apple II Plus 



Glossary 



Glossary 



J 

-J 



6502: The microprocessor used in the AppJ© Me computer. 

accumulator: The register in the 6502 microprocessor where 
most computations are performed. 

acronym: A word formed from the initial letters of a name or 
phrase, such as laser, from Light Amplification by Stimulated 
Emission ot Radiation. 

ADG: See analog-to-digital converter 

address: A number used to identify something, such as a 
location in the computer's memory. 

analog: Represented in terms of a physical quantity, such as a 
voltage, frequency, length, or position, that can vary smoothly 
and continuously over a range of values. For example, a 
conventional 1 2-hour clock face (remember those?) is an analog 
device that represents the time ot day in terms of the angles of 
the dock's hands. Compare digital. 

analog-to-digital converter: A device that converts quantities 
from analog to digital form. For example, the Apple lie's hand 
control converts the position of the control dial (an analog 
quantity) into a discrete number (a digital quantity) that changes 
abruptly even when the diai is turned smoothly. 

AND: A logical operator that produces a true result if both of its 
operands are true, a false result if either or both of its operands 
are false; compare OR, exclusive DR, not. 

Apple He: A personal computer in the Apple 11 family, 
manufactured and sold by Apple Computer. 

Apple lie BO-Column Text Cafd: A peripheral card made and 
sold by Apple Computer that plugs into the Apple lie's auxiliary 
slot and converts the computer's display of text from 40- to 80- 
column width. 
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Apple lie Extended 80-Column Text Card: A peripheral card 
made and sold by Apple Computer that plugs into the Apple lie s 
auxiliary slot and converts the computer's display of text from 40- 
\o 80-column width while extending its memory capacity by 64K 
bytes. 

Applesoft: An extended version of the BASIC pfogramming 
language usecf with the Apple lie computer. An interpreter for 
creating and executing programs in Applesoft is built into the 
Apple He system in firmware, 

ASCII: American Standard Code for Information Interchange; a 
code in which the numbers from to 127 stand for text 
characters, used for representing text inside a computer and for 
transmitting text between computers or between a computer and 
a peripheral device. 

assembler: A language translator that converts a program 
written in assembly language into an equivalent program in 
machine language 

assembly language: A low-ievel programming language in 
which individual machine-language instructions are written in a 
syrnbolic form more easily understood by a human programmer 
than machme language Ftself. 

auxiliary slot: The special expansion siot Inside the Apple lie 
used for the Apple &0-CoEumn Text Card or Extended eO-Column 
Text Card. 

back panel: The rear face of the Apple He computer, which 
includes the power switch, the power connector, and connectors 
for a video display device, a cassette tape recorder, and other 
peripheral devices, 

bandwidth; A measure of the range of frequencies a device can 
handle. In the case of a video monitor, greater bandwidth 
enables it to display more information; to display 80 columns of 
text, a monitor should have a bandwidth of at least 12 MHz. 

base address: In indexed addressing, the fixed component of an 

address. 

binary: The representation of numbers in terms of powers of 
two, using the two digits and i . Commonly used in computers, 
since the values and i can easily be represented in physical 
form in a variety of ways, such as the presence or absence of 
current, positive or negative voftago, or a white or bjack dot on 
the display screen. 
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binary operator: An operator that combines two operands to 
produce a result; for example, OR as a binary logical operator. 
Compare unary operator. 

bit; A binary digit (o or i ): me smallest possible unit oi 
mformation, consisting of a simple two-way choice, such as yes 
or no, on or off, positive or negative, something or nothing. 

bit bucket: The final resting place of all information; see write- 
only memory. 

board: See printed-circuit board. 

boot: To start up a computer by loading a program into memory 
from an external storage medium such as a disk. Often 
accomplished by first loading a small program whose purpose is 
to read the larger program into memory. The program is said to 
■ pull itself in by its own bootstraps' ^ hence the term 
bootstrapping or booting. 

bootstrap: See boot. 

buffer; An area of the computer's memory reserved for a 
specific purpose, such as to hold graphical information to be 
displayed on the screen or \ext characters being read from some 
peripheral device. Often used as an intermediary "'holding area" 
for transferring Information between devices operating at different 
speedSr such as the computer's processor and a printer or disk 
drive. Information can be stored into the buffer by one device 
and then read out by the other at a different speed. 

bus; A group of wfres that transmit related informatfon, such as 
the bits of an address, from one part of a computer system to 
another. 

byte: A unit of information consisting of a fixed number of bits; 
on the Apple Me, one byte consists of eight bits and can hold any 
value from to 2SS. 

card: See peripheral card^ 

carrier: A broadcast radio signal that is modulated in order to 
transmit information. 

carry flag: A status bit in the 6502 microprocessor, used in 
addition and subtraction to hold the high-order bit (the carry bit), 

cathode>ray tube: An electronic device, such as a television 
picture tube, that produces images on a screen coated with 
phosphors that emit light when struck by a focused beam of 
electrons. 
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central processing unit: See processor, 

character: A letter, digit, punctuation mark, or other written 
symbol used in printing or displaying information in a form 
readable by humans. 

character code: A number used to represent a text character for 

processing by a computer system. 

chip: The small piece of semiconducting materiai (usually silicon) 
on which an integrated circuit is fabricated. The word chip 
properiy refers only to the piece of Silicon itself, but is often used 
for an integrated circuit and jts package; see integrated circuit. 

code: (1 ) A number or symbol used to represent some ptece of 
information in a compact or easily processed form. (2) The 
statements or rnstnjctions making up a program. 

cold start: The process of starting up the Apple Me when the 
power is first turned on (or as if the power had just been turned 
on) by loading the operating system into main memory, then 
loading and njnning a program. Compare warm start. 

command: A communication from the user to a computer 
system (usually typed from the keyboard) directing it to perform 
some immediate action. 

compiler: A language translator that converts a program written 
in a high-level programming language into an equivalent program 
in some lower-level language {such as machine language) for 
later execution. Compare interpreter. 

component: A part; in particular, a part of a computer system. 

composite video: A video signal that includes both display 
information and the synchronization (and other) signals needed to 
display it. 

computer: An electronic device for performing predefined 
(programmed) computations at high speed and with great 
accuracy. 

computer system: A computer and fts associated hardware, 
firmware, and software. 

connector: a physical device such as a plug, socket or jack, 
used Jo connect one hardware component of a system to 
another. 
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control character: A character that controls or modifies the 
way information is printed or displayed Control characters have 
ASCII codes between O and 3i and are typed from the Apple Me 
keyboard by holding down the CONTROL | key while typing some 
other character. For example, the character [ cQNTROlI -m (ASCH 
code 1 3) means "return to the beginning of the line" and is 
equivalent to the fRETURN I key. 

controlJer card: A peripheral card that connects a device such 
as a printer or disk drive to the Apple lie and controls the 
operation of the device. 

CPU: Central processing unit; see processor 

crash: To cease operating unexpectedly, possibly damaging or 
destroying information in the process. 

CRT: See cathode-ray tube. 

cursory A marker or symbol displayed on the screen that marks 
where the user's next action wiJI take effect or where the next 
character typed from the keyboard will appear, 

DAC; See digitaMo'-analog conuerter, 

data: fnformation; especially information used or operated on by 
a program. 

debug: To locate and correct an error or the cause of a problem 
or malfunction in a computer system. Typically used to refer to 
software- related problems; compare iroubleshoot. 

decimal: The common form of number representation used in 
everyday life, in which numbers are expressed in terms of 
powers of ten, using the (en digits o to 9, 

default; A value, action, or setting that is automatically used by 
a computer system when no other explicit information has been 
given. For example, if a command to run a program from a disk 
does not identify which disk drive to use, the Disk Operating 
System will automatically use the same drive that was used in 
the last operation. 

defenestration: The act of throwing something through, from, or 
out of a window. Not recommended handling of an Apple Me. 

demodulate: To recover the information being transrpitted by a 
modulated signal; for example, a conventional radio receiver 
demodulates an incoming broadcast signal to convert it into 
sound emitted by a speaker. 
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device: (1 ) A physical apparatus for performing a particular task 
or achieving a particular purpose. (2) In particular, a hardware 
component of a computer system, 

device handler: See device driver. 

device driver: A program that manages the transfer of 
information between the computer and a peripheral device. 

digit: {1) One of the characters to 9, used to express numbers 
in decimal form. {2) One of the characters used to express 
numbers in some other form, such as and 1 in binary or to 9 
and A to F in hexadecimal. 

digital: Represented in a discrete (noncontinuous) form, such as 
numerical digiis. For examplen contemporary digital clocks display 
the time in numerical form (such as 257) instead of using the 
;|iositions of a pair of hands on a clock face. Compare analog. 

digital-to-analog converter: A device that converts quantities 
from digital to analog form. 

DIP: See dual in-line package. 

disassembler: A language translator that converts a machine- 
language program into an equivalent program in assembly 
language, more easily understood by a human programmer. The 
opposite of an assembler. 

disk: An information storage medium consisting of a flat, circular 
magnetic surface on which information can be recorded in the 
form of small magnetized spots, similarly to the way sounds are 
recorded on tape 

disk controller card: A peripheral card that connects one or two 
disk drives to the Apple Me and controls their operation. 

disk drive: A peripheral device that writes and reads information 
on the surface of a magnetic disk. 

diskette: A term sometimes used for the small (5-1/4-tnch) 
flexibie disks used with the Apple Disk II drive. 

Disk II drive: A model of disk drive made and sold by Apple 
Computer for use with the Apple lie computer; uses 5-1 /4-inch 
flexibie ("floppy") disks. 

Disk Operating System: An optional software system for the 
Apple lie that enables the computer to controt and communicate 
with one or more Disk 91 drives, 

display: (1 ) Information exhibited visually, especially on the 
screen of a display devfce. (2) To exhibit information visually. (3) 
A display device. 
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dispJay device: A device that exhibits information visually, such 
as a television receiver or video monitor. 

display screen: The glass or plastic panel on the front of a 
dispfay device, on which images are displayed. 

DOS: See Disk Operating System 

dual in-lme package; An integrated circuit packaged in a narrow 
rectangular box with a row of metal pins along each side; simiiaf 
in appearance to an armored centipede. 

edit: To change or modify; for example, to insert, remove, 
replace, or move text in a document. 

editor: A program that enables the user to create and edit 
information of a particular form; for example, a text editor or a 
graphics editor. 

effective address: In machine-language programming, the 
address of the memory location on which a particular instructfon 
actually operateSr which may be arrived at by indexed addressing 
or some other addressing method. 

error message: A message displayed or printed to notify the 
user of an error or problem in the execution of a program. 

escape mod e: A s tate of the Apple He computer, entered by 
pressing the [escJ key, m which certain keys on the keyboard 
take on special meanings for positioning the cursor and 
controlfing the display of text on the screen. 

escap e sequence: A sequence of keystrokes beginning with the 
I ESC I key, used for positioning the cursor and contfolling the 
display of text on the screen. 

exclusive QR: A logical operator that produces a true result if 
one of its operands is true and the other false, a false result if its 
operands are both true or both false; compare QRi and, HOT. 

execute: To perform or carry out a specified action or sequence 
of acttons, such as those described by a program. 

expansion slot: A connector inside the Apple He computer in 
which a peripheral card can be installed; sometimes called 
peripheral slot. 

firmware: Those components of a computer system consisting of 
programs stored permanently in read-only memory. Such 
programs (for example, the Applesoft interpreter and the Apple 
lie Monitor program) are built into the computer at the factory; 
they can be executed at any time but cannot be modified or 
erased from main memory. Compare hardware, software. 
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fixed-point: A method of representing numbers inside the 
computer tn which the decimal point (more correctiy, the binary 
point) is considered to occur at a fixed positron within the 
number. Typically, the point is considered to lie at the right end 
of the number, so that the number is interpreted as an integer. 
Compare floating-point. 

flexible disk: A disk made of flexible plastic; often called a 
"floppy" disk. Compare rigid disk, 

floating-point: A method of representing numbers inside the 
computer in which the decimal point {more correctly, the binary 
point) is permitted to "floaf ' to different positions within the 
number Some of the bits within the number itself are used to 
keep track of the point's position. Compare fixed-point, 

GAME lyo connector: A special 16-pin connector inside the 
Apple He, originally designed for connecting hand controls to the 
computer, but also used for connecting some other peripheral 
devices. Compare hand control connector. 

graphics: (1 ) Information presented in the form of pictures or 
images. {2) The display of pictures or images on a computer's 
display screen. Compare teKt. 

hand control: An optional penpheral device that can be 
connected to the Appie He's hand control connector and has a 
rotating dial and a pushbutton; typically used to control game- 
playing programs, but can be used in more serious applications 
as well. 

hand control connector: A 9-pin connector on the Apple lie's 
back panel, used for connecting hand controls to the computer. 
Compare GAME I/O connector. 

hardware: Those components of a computer system consisting 
of physical (electronic or mechanical) devices. Compare 
software, firmware, 

hertz: The unit of frequency of vibration or oscillalionf also called 
cycles per second; named for the physicist Heinrich Hertz and 
abbreviated Hz. The current provided by a standard power outlet 
alternates at a rate of 60 hertz; that is , it changes polarity 60 
times each second. The Apple He's 6502 microprocessor 
operates at a clock frequency of 1 million hertz, or 1 megahertz 
(MHz). 
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hexadecimal: The representatton of numbers in terms of 
powers of sixteen, using the si>rteen digits o to 9 and A to F 
Hexadecimal numbers are easier for humans to read and 
understand than binary numbers, but can be converted easily 
and directly to binary form: each hexadecimal digit corresponds 
to a sequence of four binary digits, or bits. 

high-level language: A programming language that is relatively 
easy for humans to understand. A single statement in a high- 
levei language typically corresponds to several instructions of 
machine language, 

high-order byte: The more significant half of a memory address 
or other two-byte quantity. In the Apple lie's 6502 
microprocessor, the low-order byte of an address is usually 
stored first and the high-order byte second. 

high-resolution graphics: The display of graphics on 

the Appie lie's display screen as a six-color array of points, £80 

columns wide and 192 rows high. 

hold time: In computer circuits, the amount of lime a signal 
must remain valid after some related signal has been turned off, 
compare setup time. 

Hz: See hertz. 

IQ: See Integrated oircult. 

information: Facts, concepts^ or instructions represented in an 
organized form, 

index: (1 ) A number used to identify a member of a list or table 
by its sequential position. {2) A list or tabEe whose entries are 
identified by sequential position. (3) In machine-language 
programming, the variable component of an indexed address, 
contained in an index register and added to the base address to 
form the effective address. 

indexed addressing: A method of specifying memory addresses 
used in machine-language programming. 

index register: A register in a computer pnDcessor that holds an 
index for use in indexed addressing. The Apple lle^s 6502 
microprocessor has two index registers, called the x register and 
the V register. 

input: (1 ) Information transferred into a computer from some 
externaE source, such as the keyboard, a disk drive, or a modem. 
(2) The act or process of transferring such information. 
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instruction: A unit of a machine-language or assembly-language 
program corresponding to a single action tor the computer's 
processor to perform. 

Integer: A whole number, with no fractional pari; represented 
inside the computer in fixed-point form. Compare real number. 

integrated circuit: An electronic component consisting of many 
circuit elements fabricated on a single piece of semiconducting 
material, such as silicon; see chip. 

Interface: The devices, rules, or conventions by which one 
component of a system communicates with anotlier. 

interface card: A peripheral card that Implements a particular 
interface {such as a parallel or serial interlace) by which the 
computer can communicate with a peripheral device such as a 
printer or modem. 

interpreter: A language translator that reads a program written 
in a particular programming language and immediately carries out 
the actions that the program describes. Compare compiler 

Interrupt: A temporary suspension in the execution of a program 
by a computer in order to perform some other task, typically in 
response to a signal from a peripheral device or other source 
external to the computer. 

inverse video: The display of text on the computer's display 
screen in the form of biack dots on a white (or other single 
phosphor color) background, instead of the usual while dots on a 
black background. 

I/O: Input/output; the transfer of information into and out of a 
computer. See input, output. 

I/O device: Input/output device; a device that transfers 
information into or out of a computer. See input, output 
peripheral device. 

I/O link: A fixed location that contains the address of an input/ 
output subroutine in the Apple lie Monitor program. 

K: Two to the tenth power, or 1024 (from the Greek rootA/to, 
meaning one thousand); for example, 64K equals 64 times 1024, 

or 65,536. 

keyboard: The set of keys built into the Apple lie computer, 
similar to a typewriter keyboard, for typing information to the 
computer. 

keystroke: The act of pressing a single key or a combination of 
keys {such as f cdhtrdl j -C) on the Apple lie keyboard. 
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kilobyte: A unit of informatjon consisting of 1K (1024) bytes, or 
eK (8192) bits: see K. 



KSW: The symbolic name of the locatfon in the Apple lie's 
memory where the standard fnput link is stored; stands for 
"keyboard switch." See f/0 link. 

language: See programmmg language. 

language translatorr A system program that reads a program 
written in a particular programming language and either executes 
it directly or converts it into some other language {such as 
machine language) for later execution. See interpreter, 
compiler, assembler. 

load: To transfer information from a peripheral storage medium 
[such as a disk) into main memory for use; for example, to 
transfer a program into memory for execution. 

location: See memory location. 

logical operator: An operator, such as i^ND, that combines 
logical values to produce a logical result, 

low-level language; A programming language that is relatively 
close to the form that the computer's processor can execute 
directly. Low-level languages available for the Apple lie include 
6502 machine language and 6502 assembly language, 

low-order byte: The less significant half of a memory address or 
other twO'byte quantity. In the Apple He's 6502 microprocessor, 
the low-order byte of an address is usually stored first and the 
high-order byte second. 

low-power Shottkey: A type of TTL integrated circuit having 
lower power and higher speed than a conventional TTL 
integrated circuit 

low-resolution graphics; The display of graphics on the 
Apple lie s display screen as a sixteen-color array of blocks, 
40 columns wide and 48 rows high. 

LS: See low-power Shottkey, 

machme language: The form in which instructions to a 
computer are stored in memory for direct execution by the 
computer's processor Each model of computer processor [such 
as the 6502 microprocessor used in the Apple He) has its own 
form of machtne language. 
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main memory; The memory componervt of a computer system 
that is built into the computer itself and whose contents are 
directly accessible to the processor. 

memory: A hardware component of a computer system that can I 
store information for later retrie\/al; see main memory, random- I 
access memory, read-only memory, read-wrile memory, 
write-only memory 

memory location; A unit of main memory that is identified by 
an address and can hold a single item of information of a fixed 
size; in the Apple lie. a memory location holds one byte, or eight 
bits, of Information. l ^ 

memory-resident: (1) Stored permanently in main memory, as I 
firmware. (2) Held continually In main memory even while not in ^ I 
use, as the Di^k Operating System. 

MHz: Megahertz; one million hertz. See hertz. 

microcomputer: A computer, such as the Apple Me, whose 

processor is a microprocessor. 

microprocessor: A computer processor contained in a single 
integrated circuit, such as the B5Q2 microprocessor used in the 
Apple lie. 

microsecond: One millionth of a second; abbreviated fxs. 

mHlisecond: One thousandth of a second; abbreviated ms. 

mode: A state of a computer or system that determines lis 
behavior. 

modem: Modulator/demodulator; a peripheral device that 
enables the computer to transmit and receive information over a 
telephone line. 

modulate: To modify or alter a signal so as to transmit 
information; for example, conventional broadcast radio transmits 
sound by modulating the amplitude (amplitude modulation, or 
AM) or the frequency (frequency modulation, or FM) of a carrier 
signal. 

monitor: See video monitor 

Monitor program: A system program built into the Apple He in 
firmware, used for directly inspecting or changing the contents of 
main memory and for operating the computer at the machine- 
language level. 

nanosecond: One billionth (in British usage, one thousand- 
millionth) of a second; abbreviated ns. 
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network: A collection of interconnected, individually controlled 
computers, together with the hardware and software used to 
connect ttiem. 

nibble: A unit of information equal to half a byte, four bits, or 
fifty cents; can hold any value from to l B. Sometimes spelled 
rtybbfe . 

NOT; A unary logical operator that produces a true result if its 
operand is false, a false result if its operand is true: compare and, 

OR, «?Kclu3i ve OR. 

NTSC: (1) National Tefevision Standards Committee; the 
committee that defined the standard format used for transmMng 
broadcast video signals in the UnUed States. (2) The standard 
video format defined by the NTSC. 

object code: See object program. 

object program; The translated form of a program produced by 
a language translator such as a compiler or assembier; also 
called object code. Compare source program. 

op code: See operation code. 

operand: A value to which an operator is applied. 

operating system: A software system that organises the 
computer's resources and capabilities and makes them available 
to the user or to application programs running on the computer. 

operation code: The part of a machine-ianguage instruction that 
specifies the operation to be performecJ; often called op code. 

operator: A symbol or sequence of characters, such as * or and, 
specifying an operation to be performed on one or more values 
(the operands) to produce a result. 

OR: A iogical operator that produces a true result if either or both 
of its operands are true, a false result if both of its operands are 
false; compare exc luaive OR, and, not. 

output: (1 ) Information transferred from a computer to some 
external destination, such as the display screen, a disk drive, a 
printer, or a modem, (2) The act or process of transferring such 
information. 

page: (1) A screenful of information on a video display, 
consisting on the Apple lie of 24 lines of 40 or 80 characters 
each, (2) An area of main memory containing text or graphical 
information being displayed on the screen. (3) A segment of main 
memory 256 bytes long and beginning at an address that is an 
even multiple of 256 bytes. 
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page zerc: See zero page. 

parallel interface: An interface in which many bits of information 
(typicaiiy eight bits, or one byle) are transmitted sfmuitaneously 
over different wires or channels. Compare serial Interface. 

PC board: See printed-circuit board. 

peripheral: At or outside the boundaries of the computer Itself, 
either physically (as aperipheraf device) or in a logical sense 
(as a peripheral card). 

peripheral bus: The bus used for transmitting information 
between the Apple lie computer and peripheral devices 
connected to the computer s expansion slots. 

peripheral card: A removable printed-circuil board that plugs 
into one of the Apple lie's expansion slots and expands or 
modifies the computer's capabilities by connnecting a peripheral 
device or performing some subsidiary or peripheral function. 

peripheral device: A device, such as a video monitor, disk 
drive, printer, or modem, used in conjunction with a computer. 
Often (but not necessarily) physically separate from the computer 
and connected to it by wires, cables, or some other form of 
interface, typically by means of a peripheral card. 

peripheral sloti See expansion slot. 

phase: (1 ) A stage in a periodic process; a point in a cycle; for 
example, the 6502 microprocessor uses a clock cycle consisting 
of two phases called i^»0 and 01 . (2) The relationship between 
two periodic signals or processes; for example, in NTSC color 
video, the color of a point on the screen Is expressed by the 
instantaneous phase of the video signal relative to the color 
reference signal. 

pipelinings A feature of a processor that enables it to begin 
fetching the next instruction before it has finished executing the 
current instruction. All other things equal, processors that have 
this feature run faster than those without it. 

pointer: An item of information consisting of the mennory 
address of some other item. 

pop: To remove the top entry from a stack. 

port: The point of connection, usually a physical connector, 
between a computer and a peripheral device, another computer, 
□r a network. 



244 



Glossary 



power supply: The hardware component of a computer that 
draws eleclrical power from a power outlet and converts ft to the 
forms needed by other hardware components, 

printed'drcuit board: A hardware component of a computer or 
other electronic device, consisting of a Hat, rectangular piece of 
rigid malehal, commonly fiberglass, to which integrated circuits 
and other electronic components are connected. 

printer: A peripheral device that writes informatfon on paper in a 
form easily readable by humans or literate monkeys. 

processor; The hardware component of a computer that 
performs the actual compulation by directly executing instructions 
represented in machine language and stored in main memory. 

program: (1) A set of instructions describing actions for a 
computer to perform in order to accompJish some task, 
conforming to the rules and conventions of a particular 
programming ianguage. {2) To write a program 

programming language: A set of rules or conventions for 
writing programs. 

prompt: To remind or signal the user that some action is 
expected, typically by displaying a distinctive symbol, a reminder 
message, or a menu of choices on the dfsplay screen. 

prompt character: A text character displayed on the screen to 
prompt the user for some action. Often aJso identifies the 
program or component of the system that is doing the prompting; 
for example, the prompt character : fs used by the Applesoft 
BASIC interpreter, > by integer BASIC, and • by the system 
Monitor program. Also called prompting character. 

prompt message: A message displayed on the screen to 
prompt the user for some action. Also called prompting 
message. 

push: To add an entry to the top of a stack. 

radio-frequency modulator: A device for converting the video 
signals produced by a computer to a form that can be accepted 
by a television receiver. 

RAM: See random-access memory. 

random-access memory: Memory in which the contents of 
individual locations can be referred to in an arbitrary or random 
order- This term is often used incorrectly to refer to read-write 
memory, but strictly speaking both read-only and read-write 
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memory can be accessed in random order. This misuse of the 
term random-access is an attempt to confuse new users, 
creating a rite of passage and an excellent market for glossaries 
oi computer terms. Compare read-only memory, read-write 
memory, write-only memory. 

raster: The pattern of parallel lines making up the image on a 
video display screen. The image is produced by controlling the 
brightness of successive dots on the individual lines of the rastefn 

read: To transfer information into the computer's memory from a 
source external to the computer (such as a disk drive or modem) 
or into the computer's processor from a source external to the 
processor (such as the keyboard or main memory). 

read-only memory; Memory whose contents can be read but 
not written; used for storing firmware. Information is written into 
read-only memory once, during manufacture; it then remains 
there permanently, even when the computer's power is turned 
off, and can never be erased or changed. Compare read-write 
memory, random-access memory, write-only memory 

read*-write memory: Memory whose contents can both be read 
and written; often misleadingly called random-accsss mefrtory, or 
RAM. The information contained in read-write memory is erased 
when the computer's power is turned off, and is permanently lost 
unless it has been saved on a more permanent storage medium, 
such as a disk. Compare read-only memory, random-access 
memory, write-only memory, 

real number: A number that may include a fractional part; 
represented inside the computer in floating-point form^ Compare 
integer. 

register: A location in a computer processor where an item of 
information, such as a byte, is held and modified under program 
control. Registers in the 6502 microprocessor include the 
accumulator (A), two index registers (J( and Y), the stack pointer 
(S), the processor status register (P), and the program counter 
(PC), The PC register holds two bytes (sijtteen bits); the other 
registers hold one byte (eight bits) each, 

return address: The point in a program to which control returns 
on completion of a subroutine. 

RF modulator: See radio-frequency modulator. 

rigid disk: A disk made of a hard, nonflexible materiaL Compare 
flexible disk. 
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ROM: See read-only memory. 

routine: A part of a program that accomplishes some task 
subordinate to the overall task of the program. 

run: (1) To execute a program. (2) To load a program into main 
memory from a periphieral storage medium, such as a disk, and 
execute It 

SAve: To transfer anformation from main memory to a periphefal 
storage medtum for later use. 

screen: See display screen. 

scroll: To change the contents of all or part of the display 
screen by shifting information out at one end (most often the top) 
to make room for new information appearing at the other end 
(most often the bottom), producing an effect like that of moving a 
scroll of paper past a fixed viewing window. See viewport, 
window. 

serial interface: An interface in which information is transmitted 
sequentially, one bit at a time, over a single wire or channel. 
Compare parallel Interface. 

setup time: The amount of time a signal must be valid in 
advance of some event; compare hold lime. 

silicon: A non-metallic, semiconducting chemical element from 
which integrated circuits are made, Not to be confused with silica 
— that is. silicon dioxide, such as quartz, opal, or sand — or 
with silicone, any of a group of organic compounds containing 
silicon 

soft switch: A means of changing some feature of the Apple !le 
from within a program; specifically, a location in memory that 
produces some special effect whenever its contents are read or 
written. 

software: Those components of a computer system consisting of 
programs that determine or control the behavior of the computer. 
Compare hardware, firmware. 

source code: See source program. 

source program: The original form of a program given to a 
language translator such as a compiler or assembler for 
conversion into another form; sometimes called source code. 
Compare object program. 

space character: A text character whose printed representation 
is a blank space, typed from the keyboard by pressing the [SPACE] 
bar. 
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stack: A Sist In which entries are added or removed at one end 
only (the top of the stack), causing them to be removed in LIFO 
(last-in first-out) order. 

string: An item of information consisting of a sequence of text 
characters. 

strobe: (1) An event, such as a change tn a signal, that triggers 
some action. (2) A signal whose change is used to trigger some 
action. 

subroutine: A part of a program that can be executed on 
request from any point in the program, and which returns control 
to the pornt of the request on completion, 

system: A coordinated collection of interrelated and interacting 
parts organized to perform some function or achieve some 
purpose. 

television receiver: A display device capable of receiving 
broadcast video signals (such as commercial television) by 
means of an antenna. Can be used in combination with a radio- 
frequency modulator as a display device for the Apple lie 
computer. Compare video monitor. 

television set: See televisiofi receiver. 

terminah A device consisting of a typewriterlike keyboard and a 
display device, used for communicating between a computer 
system and a human user. Personal computers such as the 
Apple He typically have all or part of a terminal built into them. 

text: (1 ) Information presented in the form of characters readable 
by humans. (2) The display of characters on the Apple lie s 
display screen. Compare graphlcs^ 

text window: An area on the Apple lie's display screen within 
which text is displayed and scrolled. 

transistor-transistor logic; (1 ) A family of integrated circuits 
used in computers and related devices. (2) A standard for 
interconnecting such circuits that defines the voltages used to 
represent logical zeros and ones. 

troubleshoot: To locate and correct the cause of a problem or 
malfunction in a computer system. Typically used to refer to 
hardware-related problems; compare debug. 

TTI^; See transistor-transistor logic. 

unary operator: An operator that applies to a single operand; 
for example, the minus sign (-) in a negative number such as -G 
is a unary arithmetic operator. Compare binary operator. 
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user: The person operating or controlling a computer system. 

user interface: The rules and conventions by which a computer 
system communicates with the person operating it. 

vector: (1) The starting address of a program segment, when 
used as a common point for transferring control from other 
programs. (2) A memory location used to hold a vector, or the 
address of such a location. 

video: [1 ) A medium for transmittrng information in the form of 
images to be displayed on the screen of a cathode-ray tube. (2) 
Informatron organized or transmitted in video form. (3) An early 
space pioneer. 

video monitor: A display device capable of receiving video 
signals by direct connection only, and which cannot receive 
broadcast signals such as commerciai television Can be 
connected directly to the Apple Me computer as a display device. 
Compare television receiver. 

viewport: All or part of the display screen, used by an 
application program to display a portion of the information (such 
as a document, picture, or worksheet) that the program is 
working on. Compare window. 

warm start: The process of restarting the Apple He after the 
power is already on, without reloading the operating system into 
main memory and often without losing the program or information 
already in main memory. Compare cold start. 

window: (1) The portion of a collection of information (such as a 
document, picture, or worksheet) that is visible in a viewport on 
the display screen; compare viewport. (2) A viewport (3) A flat, 
rectangular panel, usually made of silica, used in many archaic 
structures as a human-to-nature interface. 

word: A group of bits of a fixed size that is treated as a unit: the 
number of bits in a word is a characteristic of each particular 
computer. 

wraparound: The automatic continuation of text from the end of 
one line to the beginning of the next, as on the dfspiay screen or 
a printer. 

write: To transfer information from the computer to a destination 
external to Ihe computer [such as a disk drive, pnnter, or 
modem) or from the computer's processor to a destination 
external to the processor (such as main memory). 
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write-only memory: A form of computer memory into which 
information can be stored but never, ever retrieved, developed 
under government contract in 1975 by Professor Homberg T. 
Farnsfarfle. Farnstarfle s origmal prototype, approximately one 
inch on each side, l~ias so far been used to store more than 100 
trillion words of surplus federal information. Farnsfarfle s critics 
have denounced his project as a six-million-dollar boondoggle, 
but his defenders point out that this excess information would 
have cost more than 250 billion dollars to store in conventional 
media. Compare read-only memory, read-write memory, 
random-access memory. 

X register: One of the index registers in the 6502 
microprocessor. 

Y register: One of the Index registers in the 6502 

microprocessor. 

zero page: The first page (256 bytes) of the Apple lie s memory, 
also called page zero. Since the hSgh-order byte of any address 
in this page is ^ero, only the low-order byte is needed to specify 
a zero-page address; this makes zero-page locations more 
efficient to address, in both time and space, than locations in any 
other page of memory. 
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Ai 77-8 
A1H 77 
ft1L 77 
fS2 77-e 
A£H 77 
A2L 77 
M 77-8 
A4H 77 
AflL 77 

absolute address 108 
accumulator 54, 78-9. 126-6, 
140, 185, 187 

ADC 1 88 

addition 1 03 

address bus 6, 35, 140, 142, 
1 69-70 

address decoding, I/O 164 
address space 63. 140, 14S 
addresses 

absolute lOB 

base 64, 126-129 

in Monitor commands 88 

Mini-assembler 113 

multiplexed 151 

RAM 151 

relative 108, 114. 126 
addressing, relative 10B, 114, 
126 

addressing, zero-page 113 

ALTCHARSET SOft Switch 20. 28, 
45, 145 

alternate character set 19-21. 45. 

52-4, 156 
fiLTzP soft switch 74-7, 143 
analog inpyl memory locations 40 
analog input reset 40 
analog inputs 37. 39, 167 
AND function 52 
AND instruction 188 
annunciator memory locations 40 



ar^nuncialors 35, 37, 79, 164» 
167 

Any-l<ey-down 15, 164 
Any-key-down flag 13, 15 
Apple II 

cfiaracter sets 20 

compatibilrty 76 

GETLH 58 

making lie resemble 44 

memory use 68 
Appie H BASiC Programming 

Manual 13 
Apple II Plus 

cfiaracter sets 20 

compatibflity 76 

cursor-motion keys 56 

Oe:tln 56 

making Ills resemble 44 

memory use 68 

reset 70 
Apple keys 12, 17. 38. 40 
Apple Mini-assembler 57, 110-14 
Applesoft BASIC 

and bank-switched memar/ 68 

and page zero 64, 66, 92 

and reset rotitine 80 

and I/O subroutines 43 

decimaf addresses with 13, 27 

interpreter 6. 148 

prompt 57 

relurnif>g to 102 

statements 45 
Applesoft Reference Manual 6 
Applesoft Tutoriai 6, 58 
arrow keys 12, 58 
ASCII codes 12-17.'21 
ASC[| character set 5. 16, 19 
ASL 188 

assemblers 108, 110 
Assembler/Editor 110 



Index 



257 



assembly language 

and AUXMDVE 77 

and bank switching 70 

and display pages 29 

and I/O iinks 130 

and indirect addressing 64 

and machine ianguage 108-9 

and standard subroutines 43 

hexadecimai addresses with 13 

prompi character 57 

wvit^i Mini assembler 110-113 

asterisk 57, 87 

audio cassettes 36, 9B 

automatic repeat 1 1 

Autostart Monitor 47 

auxiliary memory 25, 30, 71-78 

auxiliary RAM 63. 71. 79 

ausciliary slot 7, 21, 71 
and reset routine 79 
and slot 3 46, 123 4, 132-3 
signals 174-5 

auxiliary-memory subroutines 76 

auxiliary-RAM enable signals 175 

fiUXMOVE subroutine 76-8 

B 

back panel 8 
backspace 5B 
backspace character 58 
bandwidth 17 
bank switches 69 
bank switching 50-71 
bank-switched memory 68-72. 
73-4 

and reset 79 
bank-switched HAM 68-70. 74, 

BO. 110 
base addresses 64, 126-129 
BASIC 

and auxiliary memory 71 

and GETLN 56-7 

and I/O 103, 129-30 

and reserved memory 7t 

and soft switches 29 

and stop-lisi mode 50 

and taping data 37 

and zero page 64 

compared to maclnine 
language 107 

Invoking Monitor from 87 

reading analog inputs 40 

reading switch input 38 

returning to from Mini- 
assembler 112 

returning to from Monitor SB, 

102 



BASIC, Applesoft 

see Applesoft BASIC 
BASIC, Integer 

see Integer BASIC 
BCC IBB 
Bcs 1S8 

BEQ 188 

BELL subroutine 36 

BIT 1 88 

bit patterns, high-resolution 161 
bit, high-order 

see high-order bit 
bit mapped 24 
black-and-wlnite monitor 24 
blanking intervals 153 
blanking, horizontal 153 
blanking, vertical 154 
blinking cursor 43, 54, 87, 110 
BHl 188 
BNE 188 

bootstrap 80 
borrow 1 85 

BPL tea 

BRK 97, 10S, 140, 1SB 
BR< requests 82 
brk: vector 131 
buffer, bus 170 
buffer, inpyt 56-8. 64, 106 
buffers, display 24, 65 
buffers, three-slate 170 
built-in BO-coiumn firmware 
see BO-cotumn Itrmware 
built-in subroutines 76-76 
bus buffer 170 
bus, address 6. 35, UO. 142. 

163, 170 
bus, data 170 
Bvc 1 88 

evs 1 39 

C 

CfiLL -151 S7, 110, 112 
cancel line 53 
CAPS LOCK key 13. 13. 17,44, 
58 

card, language S8, 70. 121 
cardSr peripheral see peripheral 

cards and 80-column text card 
carry bit 77. 78„ 187 
CAB 151 

cassette f/O 11. 35-6, 40. 9B, 

164, 166 

cassette recorder 8. 36, 166 
central processing unit 6, 140, 
143, 151 
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CH 50-1 

character generator 158-62 
Character ouiput Switch 48,129, 
130 

character set. atlernate 1 9-21 , 

45, 52-4, 158 
characlfif set. ASCII 5, 16, 19 
character set, primary 19-21, 45^ 

53, 79, 158 
character sets 19 
characters, lowercase 20. 44, 53 
characters, uppercase 20. 44. 53 
checksum 99. 100 
circuit board, main 6, 37, 121, 

139, 169, 174 
circuit, protection 139 
circuits, I/O 164-168 
circumflex 111, 114 
CLC 189 
CLD 189 

dear-strobe switch 13 

CLEDLZ 46 

CLI 189 

clock 1 4 1 

clock rate 140 

clock signals 141 , 142 

CLftEDL 46 
CLREDP 46 
CLRGfiT' 146. 177 

CLV 189 
CP1P 1B9 

Codes, hex operation 194 
codes, intructcon 188-192 
cold-start reset 80 
colon [in Monitor comrnands) 93, 
115 

color rronilor 24, 25, 160 

color signal 16D-2 

CObr television set 24, 160 

coJor television. NTSC 25 

color-bLrrsI gale 153 

colors 22 
high-resolution 24-5, 161 
low- resolution 23, 160 

Column address Strobe 151 

command characters 88 

complementary decimal 13 

composite video 17, 163 

connectors [see also slotsli 
D-type miniature 37, 167 
for cassette recorder 8 
for hand^controlfi 8, 37, 167 
for video monitor S 

conslant, tim& 39 

CONTINUE BASIC command 102 

control characters 50 



CDNTRDL key 12, 13, 17. 50. 164 

CONTROL - OPEN-flPPLE - (fESET 

81 

CDNTRDL -S 102. 116 

CONTROL -C 50, ae, 102, 116 

CONTROL -D 130 

CONTROL -E 116 

CDNTRDL -K 103, 130 

CONTROL - OPEN-APPLE - RESET 

SI 

CONTROL -P 46 ,102, 117 
CONTROL ' RESET 79-61. SB 
cawTROL -S 50 
CDNTRDL - SDLtD-APPLE - 
RESET 

81 

CGNTRDL -U 46 
CONTROL -¥ 106 

controller card, disk drive 80 
counter, horizontal 153, 155 
counter, program 109, 111 
counter, verttcal 153, 155 
counters, video 153, 157 
CDUT 43, 46, 47, 58, 101 
C0UT1 47-53, 57. 129, 

130 
cover 4 

CPU 6, 140, 143, 151 

CPX 189 

CPV 189 

CSW 48. 129, 130 

CEWH 129 

CSWL 129 

currents, supply 138 
cursor 

blinking 43, 54, 67, 110 

checkerboard 43, 110 

motion 56 

plus sign 56 

position 49-51, 57, 79 
cursor control keys 12. 55, 56 
CV 50, 51 
cycle stealing 149 

D 

D-type miniature connector 37, 
167 

daisy chairt, priority 170 
data bus 170 
data str6be 37. 167" 
debounce 164 
DEC 789 
decfmal 13, 27 
decimal, complementary 13 
decoder, keyboard character 6, 
13, 149, 154 
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DEVICE SELECT' t22, 169. 174 
DEX 189 
DEy 189 

Diagnostics ROM 148 
direcl-mennory access signal 170 
disassemblef 108 
disk drive controller card 80 
Disk Operating System see DOS 
display, video 11, 17-34, 152-62 

ao-colunnn 46. 159. 175 

buffefs 65 

display mgmory 1 54 

display mode 27 

display pages 26-30, 65, 
72. 74 

forina(s 1 9-20, 52-3 

fiashing format 19-20, 44-, 52-3 

high-resolution 161 

inverse 19-20, 46. 52-3, 101 

iow-resolytion 160 

mixed mode 19. 27 

normal 19-20, 52-3. 101 

soft swilcties 28 
DMA IN 170 
DMA DUT 170 
DMA' 144. 169-170 
DOS 

and reset 80 

and Monitor 87, 102 

1/0 links 47, 130 

link address storage 65 

page zero usage 84, 67, 92 

RAW addressing 129 
DOS Manual 65, SO. 81. 130 
DOS Tool Kit 110 

DOUN-ARl^OM 12 

dynamic RAM 143. 145, 149, 151 
E 

editing 58 
EIA 163 

Eiectronic Induslries 
Association 1 63 
EM80' 144. 175, 177 
environmental specificalions 137 
EOR 190 
E Rff 1 00 
error message 83 
errors 111 
ESC key 12. 13, 54, 56 

ESC COHTHQL -Q 46 

escape codes 55 
escape mode 56 
EXAMINE command 98 

piclu5iue-nB 81. 82 

expansion ROM 123-125 



expansion slot 3 45. 46, 79 
expansion slots 7, 80. t21 33. 
169-174 

extended 80-column text card 71 
F 

FGGGG 111, n? 
FFG9G 112, 117 

firmware [see also SO^column 

firmware) 

built-in I/O 43-58 

on peripheral cards 121 
flashing display format 19-20, 44. 

52-3 
flip-flop 124 

forced cold-start reset 79, 81 
format, inverse 19-20, 46, 

52-57. 101 
FP 47 
functions 

AND 52 

Stop-list 50 

G 

G (Monitor command) 117 
Game l,'0 1 67 
GAME I/O socket 168 
game inputs 37. 167 
gate, color-burst 1 53 
GETLN 43, 53, 56-B, 64. 88 
00 command 97, 102, 107. ill 
QOtoXY 49 
GR 147, 174, 178 
graptiics 22-34 
high -resolution 18-19. 23-5, 29, 
161 

low-resolulion 18-19, 22-3. 160 
mixed-mode 27 
grounded outlet 138 

H 

hand controls 8, 37, 167 
hand-control connector 37 
hand-control input 35. 167 
Hardware Manual 141 
hex operation codes 194 
hexadecimal 13, 14, 23, 27, 61, 

83, 113 
hexadecimal arlLhmetic 103 
high-level languages 29, 43, 

107 (see a^so names at 

languages) 
high-order bit 

and cassette I/O 37 

and color determination 
24-5, 162 
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and display format 53 

and state ol soft switches 29. 36 

of switch input byie 38 
high- resolution bit patterns 161 
high-resolytion graphics 18-19, 

23-5, 29. 161 
high-resolution graphics 

colors 25, 161 
high-resolution Page 1 24, 30, 

65. 74 

high-resolution Page 2 24. 30, 65 
HIRES soft switch 28, 74-5, 143, 

145 
HOME 46 

horizontal blanking 153 
hohzontal counter 153. 155 
horizorftal sync 1 53 

I 

I (Monitor command) 1)6 
I/O 

addre&s decoding 164 

buiit-in devices 1 1-41 

buiil-in firmware 43-58 

circuits 1 68 

drivers 121 

links, standard 46. 79, 
129-130 

memory locations 122, 132 

subroutines 43-47, 87 
l/C SELECT' 123, 124, 169, 172 
!/□ STROBE' 124, 125, 172 

IC 6 

IN* 103, 130 

IM'n command 130 

INC 190 

indejt register 61. 106, 127, 140. 
187 

index register V 78, 187 
index register X 78. 128, 187 
indirect addressing 64 
INH' 144. 169, 173 
input butter 56-58, 64, 106 
input devices 11-41 
input fgatures 53-58 
INPUT Statement 56-7 
input, hand-conltol 35, 167 
tnput-Output Unrt see JOU 
inputs 

analog 37, 39 

game 167 

switch 38. 167 
instructions, assembly 

language TOB-lt 



Instructions. 6502 186 
INT 47, 110 
IHT IN 131. 170 
INT OUT 131, 170 
INTBASIC 110 
1NTC3RDM soft switch 46 
Integer BASIC 

and bank-switched mernory 68 

and the Mini assembler 110 

and the old Monitor 47 

and RDK£Y 54 

and reset routine 70, BO 

and standard I/O 
subroutines 43 

complementary decimal 
with 1 3, 27 

page zero usage 64, 67 

prompt character 57 

returning to 1 G2 

statements 45 
Integrated circuft 6 
interlace 1 3 

interpreter, Applesoft BASIC 6 
Interpreter, Integer BASIC 110 
interrupt handler 131 
interrupt priority 131 
Interrupt requests i3l, 170 
interrupt vectors S1-2, 131 
interrupt- handling routine 1 31 
inten-upts 46, 82. 126, 131, 170 
intruction codes 180^192 
intruction cycle 140 
INVERSE command 101 
inverse display format 19-20, 44. 

46, 52-3, 101 
Jn;< 190 
I NY 190 

lOU 6, 7, 143. 145. 153, 155, 

164-7 
IRQ vector 131, 140 
IRQ' 131, 170. 173 

J 

joystick 37 

JMP intruction 79, 106. 190 
JSR instruction 127, 190 
Jump to Subroutine 127 

K 

keyboard 5, 11-17, 43-4, 83, 164 
KEYBOflRO qgrnmand 103 
keyboard data 1 3, 28 
keyboard encoder 6, 13. 149, 
164 

Keyboard input Switch 130 
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keynoafd strobe 13, 15, 28, 79, 
164 

keyboard input buffer 64 
KEVIN 43. 47. 53-56. 129-30 
keypad 165 
KSU 54, 130 
KSWH 130 
K5WL 130 

L 

L (Monitor coniTTiand) 117 
language card 68, 70. 121 
languages (see also names of 
languages) 

asseimbly 29. 108-9, 113 

ntgh-level 29, 43, 107 

machine 107- 110 
la$l opened location 09-91, 94, 

96. 107, 109 
LDA 190 
LDX 190 
LDV 190 
LED 4, 166 

LEFT'ARRnw key 12, 55 
hght-emitting dfode 4, 166 
line voltage 137 
link addresses 47. 65. 130 
link registers 130 
link, input 54 
link, output 48 

links, standard I/O 47. 79, 129- 
30 

LIST command 108-10, 113 
loudspeaker 5, 165 
low-order bits 1 3. 24 
low-order byte 78 
low-resolution graphics 18 19, 22- 
3. 160 

louv-resolution graphics blocks 22 
low-resolution graphics colors 23, 
160 

low&rcase characters 20, 44, 53 

LSR 191 

M 

M (Monitor command) 1 15 
machine language 107-10 
main circuit board 6. 37, 121 , 

139, 169, 174 
main memory 3D, 73, 75. 77. 

78. 121 
memory 

auxiliary 26, 30. 71-78 

bank^switched 68-71, 74, 79 

display 29-34. 154 

I/O 122,131 



main 30, 73, 75. 77. 78, 127 

progammable see RAM 

read-only see ROM 
memory addressing 148-151 
memory dump &9-91 
memory locations 

I/O devices 11, 13, 27, 2B, 41 

peripheral card 1 22 
Memory Management Unit 6, 

143. 151 
memory maps 29, 31-4, 62. 63 
memory organization 61-33 
memory page 1 61, 73 
memory page 2 61 
memory page 3 65 
memory page zero see zero 

page 
memory pages 61 
memory range 91 
microprocessor, 6502 6, 140-142 

accumuiator 126 

circuitry 170 

contents of registers 97 

data bus 170 

interrupt requests 131 

instructions 107, 186 

memory addressing; 61, 64, 
121, 124, 14S-151 

Stack 64. 73 

timing 142, 149. 151 
Mini -assembler 57, 110-14 
Mini-assembler commands 117 
MIXED soft switch 28, 145 
mixed-mode display 19, 27 
MMU 6,143,151 
mnemonic 108, ill, 113. 114 
Monitor, Autostart 47 
Monitor, old 47, 110 
Monitor, System 43, 57, 63-6, S7- 

117. 129-31, 148 
Monitor commands 88-107, 109. 

115-7 
Monitor RDM 14S 
monitor, black-and-white 22, 24 
monitor, COiOr 24, 25, 160 
monitor, video 8, 17, 152 
MOVE command 94-7. 105 
muitipiexed addressing 160-1 

N 

N (Monitor command) 116 
nCDNTRDL-P 129 

National Television Standards 
Committee see NTSC 

next changeable location 89. 91, 
93. 94, 96 



P 
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NMI 140 

ml' 170, 173 
NOP 191 

NORMAL command 101 
normal display format 19-20. 52- 
3, 101 

NTSC 17, 18, 24, 152, 160. 163 
NTSC color television 25 
numeric pad 165 
nybble 22, 160 

o 

old Monitor 47, 110 
opcode 1 10. 194 
OPEN-APPLE Itey 12.17,38,41. 
B1 

operand 110, 111 
operating temperature 137 
operation codes llOr 194 
□Rfl 191 

outlet, grounded 138 
output devices 11, 17-41 

annunciator 37 

cassette 36 

sIrobG 38 

video display 17-34 
output link 48 
output routine, standard 57 
overflow 78 
overflow hit 78 

P 

paddles 167 
page 1, memory 61 , 73 
page 3. memory 65 
Page 1, high-resolution 24, 30, 
65. 71 

Page 1. text 26, 32, 65. 74 
Page 2. high-resolution 24, 30, 
65 

Page 2, text 26, 27 
page 2ero see zero page 
PPiG£2 soft switch 28, 30, 72-5. 

143, 145, 161 
pages, memory 61 
PAL 143. 147. 151 
Pascal 43, 107 
PEEK 14,27,38.39 
period [.) 89 

peripheral cards 8, 121-133, 138, 
169-74 

base addresses 127-9 
I/O space 122 
fiOM space 122, 133 
subroutines 126 



peripheral devtces 121-33, 169- 
74 

peripheral hardware 137 
peripheral sfots see expansion 

siots 
PG2 158. 161 
PHA 191 

phi 141, 142, 144, 146, 147, 

151, 167, 174, 177 
phi 1 141. 142, 147, 151. 173, 

178 

phi 2 141 

phone jacks 8 
PHP 191 
pipelining 6, 140 
PLA 191 
PLP 191 

plus sign (Inverse format) 56 
pointer, stack 64, 79, 140, 185. 

187 
POf^E 27 
potentiometers 39 
power 4, 5 
power connector 139 
power consumption 138 
power cord 6, 138 
power supply 5, 138-9, 
power switch 6 
power-on reset 79 
power-up byte 81-2 
PR' 103. 130 
PR#0 46 
PR'3 46 
PR'n 129 
PftEAD 40 

primary character set 19-21. 45. 

53, 79. 158 
PRINT statement 45. 130 
PRINTER command 102. 103 
priority daisy chain 170 
processor status register 187 
program counter 1 09, ill 
program, assembly language 43 
programmable memory see RAM 
programmabEe storage 61, 63 
Programmed Array Logic 

device 143. 147. 151 
PROU 121-3 

prompt characters 43, 56, 57 

• S7 

> 110 

t 111 
protection circuit 139 
pseudo random number 54 
pull-up resistors 167 
pu s hb utton switches 1 6 7 
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o 

03 141. 144, 146, 147, 151, 173 

R 

ft (Monitor command) 99-100, 
116 

ft/W 144, 146, 176 
R/wea 175 
RAM 

and Monitor 47 
and peripheral cards 121 
and reset 79 
auxiliary 63, 71, 79 
bank-switched 68-70, 74, 80, 
110 

dynamic 143. 145, 149, 151 

memory acce$s, 61, 149 

reserved memory 63 

second bank 70 
RAMRD 73-75. 143 
RflMHRT 73-75, 143 
random number 54 
random number, pseudo 54- 
random-access memory see 

RAM 
RAB 151 

RDKEY 43, 47, 54, 56 
reading data 28 
reading to secondary I/O 35 
READ command 99-100. 116 
read only memory see ROM 
read.'write signal 142 
recorder, cassette 3, 36, IGG 
registers 97.126,140.187 (see 

also accumulator) 

index 61, 127. 140, 185, 187 

link 130 

processor status 140, 187 
program counter 187 
size of 140 

stack pointer 64. 79, 140, 185, 

187 

relative addressing 108, 114. 126 
repeating keys 1 1 
RES' 173 

reserved memory pages 63 
RESET key 12, 13. 17, 79-61. 
83 

reset rouljne 17. 79-83 
reset vector 70, 79-83 
RESET^ 146 

reset, cold-start 80 
reset, forced cold-start ai 
reset, power-on 79 
reset, warm-start 80 



resident program 81 
resistor, variable 168 
resistors, pull up 167 
restricted-case mode 58 
Return from Subroutine 108. 127, 

129, 130, 192 
retype 58 

RF modulator 17, 152 

RIGHT'ARBUW key 12,58 
ROL 191 
roliover 11 
ROM 6 
and bank-switched memory 

68-70. 73. 79 
and memory addressing 6i, 
148 

and the Monitor 47 
character-generator 161 
Diagnostics 148 
expansion 123-5 
Monitor 148 

peripheral card 125, 132-3 

KDR 191 

routines 217-223 

routines, interrupt-handllng 131 

Row-address Strobe 1 51 

RTI 192 

RTS 108, 127, 129. 130, 192 

s 

SBC 1 92 
scroiling 49, 50 
SEC 192 

second bank of RAM 70 

SED 192 
5E J 1 92 

sell test 17 83. 131, 148 

SHIFT key 12. 13. 17, 164 
Short circuits 5, 139 
signal, read/write 142 
signals, dock 141-2 
Signals, timing 141-2,. 149, 159, 

161, 162. 169 
slot number 126-30 
slot, auxiliary see auKiiiary slot 
slot, expansion see expansion 

slots 

SL0TC3RDM 132, 133. 143 
SLOTCXROn 1 32, 143 
slots, ventllalion 137 
soft switches 27. 92. 127, 143, 

145 (see also names of 

switches) 

and self test 83 

annunciator 37 

auxiliary memory 75 

bank select 69, 73-6, 79 
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definition 15 
dispfay 1 1 , 28 
game S/O 167 
keyboard 164 
speaker 35 

SOLID-APPLE key 12, 17. 38. 
41, at, 83 
sounds 5 

speaker 5. 11. 3&, 164. 166 

memory locations 41 

soft switches 35 
special function keys 1 7 
specificafions, environmental 137 
BTA 1 92 

stack 64. 74. 78. 126 
stack overflow G4 
stack pointer 64, 79, 140. 185, 
187 

standard I/O links 47, 79, 129-31 
standard I/O subroutines 43-57, 
97 

standard input routine see KEVIN 

standard output routine see COUT 

startup 80 

stop-list feature 50 

stop-list function 50 

strobe 

column -address 151 

data 37, 167 

keyboard 13, 15, 28. 79. 164 
row-address 151 
strobe bit 14 

strobe output 35, 38, 40. 167 
STJ( 192 
STY 192 

subcarrier. color 25. 160 
subroutines 217-223 

auxiliary merTiory 76-79 

buitt-in 76-79 

I/O 43-58. 87 

peripheral -card 126 

standard input 54, 56 
sutjtraction 1 03 
suppiy currents 138 
suppiy voltage 138 
switch 38 
switch 1 38 
switch inputs 38. 167 
swilches. pushbutton 167 
symbolic tabeis 1 10 
5¥MC' 146. 153, 174 
sync, horizontal 153 
Synertek Hardware Manita! 141 
Synertck Programming 

Manual 113 



System Monitor see Monitor. 
System 

T 

tape recorder 36, 98, 166 
TAX 192 
Tftv 192 

television set 17, 22, 24. 25, 152 
temperature 137 
ten-key numeric pad 165 
TE)(T sofi switch 28. 146 
text 19-21,26-32 
text card see ao-column text card 
text card, extended ao-cofumn 71 
text characters see character 
sets 

text Page 1 26, 32, 65. 74 
text Page 2 26, 27 
text window 48-52. 79 
text, 40-column see 40-coiumn 
text 

textf SO'Column see 80-column 
text 

three-state buffers 170 

time constant 39 

timing signals 141-2, 149, 159, 

161. 162. 169 
toggle 35 

transistor-transistor logic 167 
TSx 192 
TTL 167 

TV set see television set 
TXA 193 
TX5 193 
TVA 193 

u 

UP-flRRUN 12 

uppercase characters 20, 44, 53 
uppercase- restrict mode 45 

V 

V (r^lonttor command) 115 
validity-check byte 80.. B2 
variable resistor 168 
VBL 28, 145. 154 
vectors 47, 65, 71 

mterrupt 81-2. 131 

reset 70, 79-83 
ventitation sFots 137 
VE,R1FY command 96, 97, 105 
vertical blanking 145, 154 
vertical counter 153, 155 
video counters 153. 157 
video display see display, video 
video modulator 17, IS 
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video rnonilor B, 17, 152 
video ouipLit signal 25. 163 
voUage. line 137, 138 
voltage, supply 13B 

w 

u {Monitor command) 98 100, 
116 

warm-slart reset 80 

window, text 48-52 

WNDW 146. 153, 176 

WRITE command 98-100, 116 

write-protect 69 

writing data 28 

writing to secondary I/O 35 

X 

X register 78. 187 
XFEff 7B-9 

Y 

V register 7S, 128, 187 

z 

zero page 61. 64, 66-7, 73-8, 92, 

113. 126 
zero-page addressing 1 1 3 

Numbers 

MM 141, 147, 177 

3.50 MHz color signal 160-2 

a.SBM: (PAL Signal) 147 

3. sen (slot 7 signal) 174 

3 . SSM (auxtliary slot signal) 1 76 

3D0G 102 

40-column text IB. 2G. 44, 154 
6502 iTiicrQiprocessor 

see microprocessor. 6502 
6502 stack 73 
6502B microprocessor 6, 140 
7n 141, 147, 173. 178 
BO-column display 7, 30, 46, 72, 

159. 175 
BO-colurrn firmware 

123-24 

cnuTi subroutine 

deactivating 102 

in ROM 148 

►tEYJK subroutine 

memory use 131, 

reset routine 79 
BO-column text 

154, 162. 175 
8Q-CQlumn text card 7, 17, 21, 

46, 71, 133 
80-colunnn XqkX mode 26 
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45-47. 110, 



52 



54. 56 
133 



IB, 21, 30, 44, 



SOCDL soft switcti 28„ 145, 161 
eOSTURE soft Swilctl 28. 30. 72- 

75, 143, 175 
eoviD soft switch 158. 161 
BoyiD' signal 146. 147. 177 

Cast of Characters 

A 111, 114 
? 57 

> 57, 110 
1 57 
' 57, 87 
! 57, 111 
89 

$ (in addresses) 113 
$ (with Monitor cornmand) 111, 
117 

: (in Monitor commands) 93, 115 
-»■ (inverse format) 56 

CONTSQL -B 102, 116 
CQNTRDL -C 50, 88. 102, 116 
130 

116 

103, 130 
46. 102. 117 
50 
46 
106 

«A0 141, 142. 144. 146, 147, 150, 

167, 174, 177 
(fri 141, 142, 147, 150, 173. 173 
i/»2 141 



CONTRDL ~D 

GONTRnL -E 
C□r^TRDL -K 
CONTROL -P 
CONTROL -S 
CQMTROL 'U 
CDHTROL -V 
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